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Introduction 

This manual is intended to supplement information contained 
^ in the User's Reference Manual and the Programmer's Reference 

K Manual, It provides an easy reference volume for those responsi- 

ble for administering a 6000/50 system. 

The manual is divided into two sections: 

1. System Maintenance Commands and Application 

Programs 
7. Special Files 

Throughout this volume, a reference of the form name(1M), or 
name(7), refers to entries in this manual, while all other references 
to entries of the form name(N), where N is a number, possibly fol- 
lowed by a letter, refer to entry name in Section N of the User's 
Reference Manual or the Programmer's Reference Manual, 

Section 1 (System Maintenance Commands and Application 
Programs) contains commands and programs that are used in 
administering a 6000/50 system. These entries carry a sub-class 
f"~"\ designation of "1M" for cross-referencing reasons. 

Section 7 (Special Files) discusses the characteristics of sys- 
tem files that refer to input/output devices. The names in this sec- 
tion generally refer to device names for the hardware, rather than 
to the names of the special files themselves. 

Each section begins with a page labelled intro. Entries follow- 
ing the intro page are arranged alphabetically and may consist of 
more than one page. Some entries describe several routines, 
commands, and so forth. In such cases, the entry appears only 
once, alphabetized under its "primary" name. An example of such 
an entry is mount^M), which also describes the umount command. 

All entries are based on a common format, not all of whose 
parts always appear: 

• The NAME part gives the name(s) of the entry and briefly 

states its purpose. 
f "\ 
K^J • The SYNOPSIS part summarizes the use of the program 

being described. A few conventions are used, particularly in 
Section 1M (Commands): 
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Boldface strings are literals and are to be typed just as 
they appear. 

Regular face strings usually represent substitutable argu- 
ment prototypes and program names found elsewhere 
in the manual. 

Square brackets [] around an argument prototype indi- 
cate that the argument is optional. When an argument 
prototype is given as "name" or "file," it always refers 
to a file name. 

Ellipses ... are used to show that the previous argument 
prototype may be repeated. 

• The DESCRIPTION provides an overview of the command. 

• The EXAMPLE(S) part gives example(s) of usage, where 
appropriate. 

• The FILES part gives the file names that are built into the 
program. 

• The SEE ALSO part gives pointers to related information. 

• The DIAGNOSTICS part discusses the diagnostic indica- 
tions that may be produced. Messages that are intended to 
be self-explanatory are not listed. 

• The WARNINGS part points out potential pitfalls. 

• The BUGS part gives known bugs and sometimes deficien- 
cies. 

A "Table of Contents" and a "Permuted Index" derived from 
the Table of Contents precede section 1 . Both are valuable 
resources to be used when locating information you need quickly 
and easily. 

The "Permuted Index" is a list of keywords, given in the 
second of three columns, together with the context in which the 
keyword is found. Keywords are either topical keywords or the 
names of manual entries. Entries are identified with their section 
numbers shown in parentheses. The right column lists the name 
of the manual page on which each keyword may be found. The 
left column contains useful information about the keyword. 
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1. Commands 

intro(1M) introduction to maintenance commands 

and application programs 

accept, reject(lM) allow or prevent LP requests 

acct: acctdisk, acctdusg, accton, acctwtmp(1 M) overview of 

accounting and miscellaneous accounting commands 

acctcms(lM) command summary from 

per-process accounting records 

acctcon: acctconl, acctcon2(1M) connect-time accounting 

acctmerg(IM) merge or add total accounting files 

acctprc: acctprd, acctprc2(1M) process accounting 

acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, 
prctmp, prdaily, prtacct, runacct, shutacct, startup, 

tumacct(IM) shell procedures for accounting 

f' ^ adv(1M) advertise a directory for remote access 

•*— - ** bcopy(1M) interactive block copy 

brc, bcheckrc, powerfail(IM) system initialization procedures 

captoinfo(IM) convert a termcap description into 

a terminfo description 

cdc(1M) change the delta commentary of an SCCS delta 

cdt(1M) read crash dump table 

checkfsys(1 M) check a file system on a removable disk 

chroot(1M) change root directory for a command 

ckbupscd(IM) check file system backup schedule 

clri(1M) clear i-node 

config(1M) configure a 6000/50 system 

cons(1M) control of system console 

cpset(1M) install object files in binary directories 

cram(1M) read/write CMOS RAM 

cramsetup(IM) set up default values in CMOS RAM 

^.^ crash(lM) examine system images 

Q j cron(1M) clock daemon 

ctinstall, getgrps(IM) install software 

dcopy(1M) copy file systems for optimal access time 

dd(1M) convert and copy a file 

devnm(1M) device name 

UP-13529 Contents 1 



Table of Contents 



df(1M) report number of free disk blocks and i-nodes 

diskusg(IM) generate disk accounting data by user ID 

diskutil(IM) display disk information, copy in crash dump files 

dname(1M) print Remote File Sharing domain and network names 

drvload(lM) load drivers 

du(1M) . summarize disk usage 

errdead(IM) extract error records and status 

information from dump 

errdemon(IM) error-logging daemon 

errpt(lM) process a report of logged errors 

errstop(lM) terminate the error-logging daemon 

ff(1M) list file names and statistics for a file system 

frec(1M) recover files from a backup tape 

fsck, dfsck, checkall(IM) check and repair file systems 

fsdb(1M) file system debugger 

fsstat(lM) report file system status 

fstyp(lM) determine file system identifier 

fumount(IM) forced unmount of an advertised resource 

fusage(1M) disk access profiler 

fuser(1M) identify processes using a file or file structure 

gencc(lM) create a front-end to the cc command 

getty(lM) set terminal type, modes, speed, and line discipline 

hinv(lM) hardware inventory 

id(lM) print user and group IDs and names 

idload(1M) Remote File Sharing user and group mapping 

infocmp(IM) compare or print out terminfo descriptions 

init, telinit(IM) process control initialization 

install(IM) install commands 

kcrash(1M) examine system images 

kdb(1M) Kernel Debug Monitor 

killall(IM) kill all active processes 

labelit(lM) provide labels for file systems 

lddrv(1M) manage loadable drivers 

link, unlink(1M) link and unlink files and directories 

lpadmin(1M) configure the LP spooling system 

Ipsched, Ipshut, lpmove(1M) start/stop the LP scheduler 

and move requests 

lpset(1M) set parallel line printer options 

masterupd(IM) update the master file 

mkdbcmd(IM) load commands into the kernel debugger 

mkdbsym(IM) add symbols to kernel debugger 

Contents 2 UP-13529 



Table of Contents 



/""""N. 



mkfs(1M) construct a file system 

mkifile(1 M) make an ifile from an object file 

mklost + found (1M) make a lost+found directory for fsck 

mknod(1M) build special file 

mount, umount(1M) mount and unmount file systems 

and remote resources 

mountall, umountall(IM) mount, unmount multiple file systems 

mvdir(1M) move a directory 

ncheck(1M) generate path names from i-numbers 

newgrp(1M) log in to a new group 

nlsadmin(IM) network listener service administration 

nmlmaint(1 M) loadable driver name list maintenance 

nsquery(1 M) Remote File Sharing name server query 

profiler: prfld, prfstat, prfdc, prfsnap, prfpr(1M) 6000/50 

system profiler 

pwck, grpck(1M) password/group file checkers 

qinstall(IM) install and verify software using 

the mkfs(1M) proto file database. 

qlist(1M) print file lists from proto file; 

set links based on lines in proto file 
rc0(1M) ... run commands performed to stop the operating system 

rc2(lM) run commands performed for multi-user environment 

reboot(1M) reboot the system 

renice(1M) alter priority of running process by changing nice 

rfadmin(IM) Remote File Sharing domain administration 

rfpasswd(IM) change Remote File Sharing host password 

rfstart(1 M) start Remote File Sharing 

rfstop(1M) stop the Remote File Sharing environment 

rfuadmin(IM) Remote File Sharing notification shell script 

rfudaemon(IM) Remote File Sharing daemon process 

rmntstat(IM) display mounted resource information 

rmount(1M) retry remote resource mounts 

rmountall, rumountall(IM) mount, unmount Remote 

File Sharing resources 

runacct(IM) run daily accounting 

sadp(1M) disk access profiler 

sar: sal, sa2, sadc(1M) system activity report package 

scpioctl(IM) download code to active SCP boards. 

scsicnfg(IM) configure devices on the SCSI bus 

setmnt(1M) establish mount table 

shutdown, halt(1M) shut down system, change system state 
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strace(1M) print STREAMS trace messages 

strclean(IM) STREAMS error logger cleanup program 

strerr(1M) STREAMS error logger daemon 

su(1M) become super-user or another user 

swap(1M) swap administrative interface 

sync(1M) update the super block 

sysadm(1M) menu interface to do system administration 

sysdef(1M) output system definition 

tic(1M) terminfo compiler 

tsdbadm(IM) Remote Terminal service database administration 

tslimit(IM) Remote Terminal service limits administration 

uadmin(1M) administrative control 

unadv(1M) unadvertise a Remote File Sharing resource 

uucheck(IM) check the uucp directories and permissions file 

uucico(1M) file transport program for the uucp system 

uucleanup(IM) uucp spool directory clean-up 

uugetty(IM) .... set terminal type, modes, speed, and line discipline 

uusched(IM) the scheduler for the uucp file transport program 

Uutry(1M) try to contact remote system with debugging on 

uuxqt(1M) execute remote command requests 

volcopy(IM) copy file systems with label checking 

whodo(1M) who is doing what 

7. Special Files 

intro(7) introduction to special files 

clone(7) open any minor device on a STREAMS driver 

disk(7) disk format and driver 

drivers(7) loadable device drivers 

enet(7) Ethernet interface and control 

err(7) error-logging interface 

fd(7) floppy disk (diskette) 

log(7) interface to STREAMS error logging and event tracing 

lp(7) parallel printer interface 

mem, kmem(7) system memory image 

null(7) the null file 

prf(7) operating system profiler 

ramdisk, uramdisk(7) RAM disk drivers 

sa(7) devices administered by System Administration 

scpa(7) SCP active mode interface 

scsi(7) SCSI busses and peripherals 

streamio(7) STREAMS ioctl commands 
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sxt(7) pseudo- device driver 

termio(7) general terminal interface 

timod(7) Transport Interface cooperating STREAMS module 

tirdwr(7) Transport Interface read/write interface 

STREAMS module 

tty(7) controlling terminal interface 

vt(7) virtual terminal 
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configure a 

advertise a directory for remote 

disk 

disk 

copy file systems for optimal 

acctcon2(1 M) connect-time 

acctprcl(IM) acctprc2(1M) process 

generate disk 

merge or add total 

run daily 

connect-Ume accounting 

accounting acctcon1(1M) 

acctwtmp(IM) 

acctdlsk(IM) 

acctdisk(IM) acctdusg(tM) 

accounting 

acctprc1(1M) 

acctdisk(IM) acctdusg(IM) accton(IM) 

SCP 

kill all 

download code to 

sa1(1M) sa2(1M) ssdc(1M) system 

merge or 

devices 

network listener service 

Remote File Sharing domain 

devices administered by System 

menu interface to do system 

Remote Terminal service database 

Remote Terminal service limits 

swap 

access 

forced unmount of an 

re|ect(1M) 

changing nice 

check file system 

recover files from a 

Initialization procedures 

install object (ties in 

interactive 

update the super 

report number of free disk 

configure devices on the SCSI 

SCSI 

create a front-end to the 

alter priority of running process by 

lastlogin(IM) monacct(IM)/ 

disk 

dfsck(1M) checkalt(IM) 

permissions file 

systems dfsck(1M) 

grpck(1M) password/group file 



6000/50 system config(1M) 

access advfl M) 

access profiler fusagefl M) 

access profiler sadp(1 MJ 

access time dcopy(l M) 

accounting acctcon1(1M) acctcon(IM) 

accounting „ acctprc(IM) 

accounting data by user ID diskusg(lM) 

accounting files .... acctmerg(lM) 

accounting .. „ runacct(lM) 

acctcon1(1M) acctcon2(1M) acctcon(lM) 

acctcon2(1M) connect-Ume acctcon(IM) 

acctdlsk(IM) acctdusg(1MJ accton(tM) acctflMj 

acctdusgtIM) accton(lM) acctwtmp(lM) acct(lM) 

accton(1M) acctwtmp(IM) acct(1M) 

acctprcl(IM) acctprc2(1M) process acctprc(lM) 

acctprc2(1M) process accounting acctprc(IM) 

acctwtmp(IM) acct(l M) 

active mode Interface scpa(7) 

active processes klllall(lM) 

active SCP boards. scploctl(lM) 

activity report package sar(lM) 

add symbols to kernel debugger mkdbsym(IM) 

add total accounting files acctmerg(lM) 

administered by System Administration sa(7) 

administration .. nlsadmin(IM) 

administration ....... rfadmln(1 M) 

Administration . sa(7) 

administration sysadm(1 M) 

administration tsdbadmjl M) 

administration tslimit(1 M) 

administrative control uadmin(1 M) 

administrative interface swap(lM) 

advertise a directory for remote adv(1M) 

advertised resource fumount(lM) 

allow or prevent LP requests acceptjl M) 

alter priority of running process by renice(1 M) 

backup schedule ekbupscd(IM) 

backup tape frec(lM) 

bcheckrc(IM) powerfall(IM) system brc(1Mj 

binary directories cpseHIM) 

block copy „ bcopy(1M) 

block sync(1 M) 

blocks and V-nodes df(1M) 

build special file mknod(1M) 

bus scsicnlg(1 M) 

busses and peripherals scsi(7) 

cc command gencc(1M) 

changing nice renice(1M) 

chargefee(IM) ckpacct(IM) dodisk(1M) acctsh(IM) 

check a file system on a removable checkfsys(l M) 

check and repair file systems fsck(1M) 

check file system backup schedule okbupscd(lM) 

check the uucp directories and uucheck(l M) 

checkall(IM) check and repair file fsek(lM) 

checkers ..... ..... pwck(1 M) 
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copy file systems with label 

monacct(IM)/ chargefee(IM) 

STREAMS error logger 

uucp spool directory 



read/write 

set up default values in 

download 

change root directory for a 

create a front-end to the cc 

execute remote 

install 

load 

environment run 

operating system run 

STREAMS ioctl 

change the delta 

descriptions 

termlnfo 



acctcon1(1M) acctcon2(1M) 
control of system 

on try to 

Ethernet interface and 

telinit(IM) process 

administrative 



Transport Interface 

convert and 

Interactive block 

time 

display disk information, 

display disk information, copy in 

read 

command 

clock 

error-logging 

terminate the error-logging 

Remote File Sharing 

STREAMS error logger 

run 

generate disk accounting 

Remote Terminal service 

Kernel 

file system 

load commands into the kernel 

add symbols to kernel 

try to contact remote system with 

setup 

output system 



checking ......™..™.„..™... — . volcopy (1 M) 

ckpacct(IM) dodlsk(1M) lastlogin(IM) acctsh(1M) 

cleanup program ................................. strclean(IM) 

clean-up „.... ............ ............... — . uucleanup(1 M) 

clear i-node clri(1M) 

clock daemon cron(IM) 

CMOS RAM cramflM) 

CMOS RAM cramsetup(IM) 

code to active SCP boards scpioctl(IM) 

command chrootjl M) 

command ............ ................. gencc(1 M) 

command requests uuxqtjlM) 

commands .................................. install (1 M) 

commands into the kernel debugger mkdbcmd(lM) 

commands performed for multi-user rc2(1M) 

commands performed to stop the rcO(1M) 

commands ....... . ........ .. streamio(7) 

commentary of an SCCS delta cdc(1M) 

compare or print out termlnfo Infocmp(IM) 

compiler „ tic(1 M) 

configure a 6000/50 system config(1M) 

configure devices on the SCSI bus scsicnfg(IM) 

configure the LP spooling system Ipadmln(IM) 

connect-ttme accounting acctcon(IM) 

console cons(1 M) 

construct a file system '. mkfs(1M) 

contact remote system with debugging ...... — UutryflM) 

control enet{7) 

control initialization lnit(1M) 

control of system console cons(1M) 

control , uadmin(1 M) 

controlling terminal Interface tty(7) 

convert and copy a file dd(1 M) 

cooperating STREAMS module : timod(7) 

copy a file dd(lM) 

copy bcopy(1 M) 

copy file systems for optimal access dcopy(1M) 

copy file systems with label checking volcopy(IM) 

copy In crash dump files diskutll(IM) 

crash dump files diskutilflM) 

crash dump table cdt(1M) 

create a front-end to the cc gencc(1 M) 

daemon cron(1 M) 

daemon errdemon(1 M) 

daemon errstop(1 M) 

daemon process rfudaemon(1 M) 

daemon strerr(1 M) 

daily accounting runacct(IM) 

data by user ID diskusg(1MJ 

database administration tsdbadm(IM) 

Debug Monitor , kdb(1M) 

debugger fsdb(1 M) 

debugger mkdbcmd(1 M) 

debugger mkdbsym(1 M) 

debugging on Uutry(1 M) 

default values in CMOS RAM cramsetup(IM) 

definition sysdef{1 M) 
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the delta commentary of an SCCS 

change the 

compare or print out terminfo 

loadable 

open any minor 

Administration 

configure 

repair file systems 

check the uucp 

install object files in binary 

unlink(1M) link and unlink files and 

uucp spool 

change root 

make a lost+found 

advertise a 

move a 

terminal type, modes, speed, and line 

terminal type, modes, speed, and line 



generate 

report number of free 

check a file system on a removable 

floppy 

uramdlsk(7) RAM 

files display 

summarize 

floppy disk 

crash dump files 

chargefeeflM) ckpacct(IM) 

who Is 

Remote File Sharing 

print Remote File Sharing 

open any minor device on a STREAMS 

disk format and 

loadable 

pseudo-device 

loadable device 

load 

manage loadable 

uramdisk(7) RAM disk 

disk information, copy in crash 

read crash 

commands performed for multi-user 

stop the Remote File Sharing 

STREAMS 

STREAMS 

interface to STREAMS 

terminate the 

process a report of logged 



delta change cdc(1M) 

delta commentary of an SCCS delta cdc(1M) 

descriptions infocmpjl M) 

determine file system Identifier fstyp(1M) 

device drivers drivers(7) 

device name devnm(1M) 

device on a STREAMS driver clone(7) 

devices administered by System sa(7) 

devices on the SCSI bus scsicnfg(IM) 

dfsck(1M) checkall(IM) check and fsck(1M) 

directories and permissions file uucheck(IM) 

directories ....... cpset(1 M) 

directories Ilnk(1 M) 

directory clean-up uucleanup(IM) 

directory for a command chroot(1M) 

directory for fsck mkios!+found(1M) 

directory for remote access adv(1M) 

directory mvdirfl M) 

discipline set getty(1M) 

discipline set uugetty(IM) 

disk access profiler fusage(1M) 

disk access profiler sadp(1M) 

disk accounting data by user IO diskusg(IM) 

disk blocks and l-nodes df(1M) 

disk checkfsys(1 M) 

disk (diskette) Id(7) 

disk drivers ramdisk(7) 

disk format and driver disk(7) 

disk information, copy in crash dump diskulil(IM) 

disk usage du(1M) 

(diskette) Id(7) 

display disk information, copy in diskutil(IM) 

display mounted resource information rmntstat(IM) 

dodlsk(1M) lastlogln(IM) monacct(IM)/ acctsh(1M) 

doing what whodo(1M) 

domain administration rfadmin(IM) 

domain and network names dname(1M) 

download code to active SCP boards scpioctl(IM) 

driver clone(7) 

driver disk(7) 

driver name list maintenance nmlmalnt(IM) 

driver sxt(7) 

drivers drivers(7) 

drivers drvload(1 M) 

drivers Iddrv(1 M) 

drivers ramdisk(7) 

dump files display diskutil(IM) 

dump table cdt(1M) 

environment njn rc2(1M) 

environment .- rfstop(1 M) 

error logger cleanup program strclean(IM) 

error logger daemon strerr(1M) 

error logging and event tracing log(7) 

error-logging daemon errdemon(IM) 

error-logging daemon errstop(IM) 

error-logging Interface err(7) 

errors errpt(1 M) 
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establish mount table setmnt(1M) 

Ethernet Interface and control enet(7) 

to STREAMS error logging and event tracing Interface log(7) 

examine system Images crash(1Mj 

examine system Images kcrash(1 M) 

execute remote command requests uuxqt(1M) 

grpck(1M) password/group file checkers pwck(1M) 

convert and copy a file dd(1M) 

update the master file — masterupd{1M) 

make an ifile from an object file mkifile(IM) 

build special file mknod(1M) 

system list file names and statistics for a file ff(lM) 

the null file null{7) 

identify processes using a file or file structure fuser(1M) 

Remote File Sharing daemon process rfudaemon(IM) 

Remote File Sharing domain administration rfadmin(IM) 

print Remote File Sharing domain and network names dname(1M) 

stop the Remote File Sharing environment ristop(1Mj 

change Remote File Sharing host password rfpasswd{1M) 

Remote File Sharing name server query nsquery(IM) 

script Remote File Sharing notification shell rfuadmin(IM) 

unadvertise a Remote File Sharing resource unadv(1M) 

start Remote File Sharing rfstart(IM) 

Remote File Sharing user and group mapping idioad(1M) 

Identify processes using a file or file structure fuser(1M) 

check file system backup schedule ckbupscd(1 Mj 

file system debugger fsdb(1M) 

list file names and statistics for a file system H(1M) 

determine file system Identifier fsfyp(1M) 

construct a file system mkfs(1 M) 

check a file system on a removable disk checkfsys(lM) 

report file system status fsstat(1M) 

copy file systems for optimal access time dcopy(1Mj 

checkail{1M) check and repair file systems dfsck(1M) fsck{1M) 

provide labels for file systems labelit(IM) 

umountall(IM) mount, unmount multiple file systems ...... mountall(1M} 

copy file systems with label checking volcopy(IM) 

system file transport program for the uucp uucico(1 M) 

the scheduler for the uucp file transport program uusched(IM) 

the uucp directories and permissions file check uucheck(1 M) 

merge or add total accounting files acctmerg(1 M) 

unlink(1M) link and unlink files and directories link(1M) 

disk information, copy in crash dump files display diskutii(1MJ 

recover files from a backup tape frec(1 Mj 

install object files in binary directories cpsst(1 Mj 

introduction to special files intra{7) 

floppy disk (diskette) fd(7) 

resource forced unmount of an advertised lumount{1M) 

disk format and driver disk{7) 

report number of free disk blocks and l-nodes df(1 M) 

recover files from a backup tape frec(1M) 

make an ifile from an object file mkifile(IM) 

generate path names from i-numbers '. ncheck{1 M) 

create a front-end to the cc command gencc(l M) 

make a lost+found directory for fsck „ mklosWound(IM) 

ID generate disk accounting data by user diskusg(IM) 

generate path names from i-numbers ncheck(lM) 
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print user and 

Remote File Sharing user and 

log in to a new 

checkers 

system state 

change Remote File Sharing 

generate disk accounting data by user 

determine file system 

file structure 

print user and group 

make an 

kmem{?) system memory 

examine system 

examine system 

display disk 

telinit(IM) process control 

bcheckrc(IM) powarfatfflM) system 

clear 

report number of free disk blocks and 

directories 
gstgrpsflM) 

Ethernet 

Transport 

error-logging 

parallel printer 

SGP active mode 

swap administrative 

general terminal 



getgrps(IM) Install software . 
group IDs and names . 
group mapping 
group 



.ctlnstall(IM) 
, ld(1M) 



grpek{1M) password/group tile 

halt(1M) shut down system, change 
hardware Inventory 
host password ......... 

ID 



o 



and event tracing 
controlling, terminal 

generate path names from 

hardware 

STREAMS 

load commands Into the 
add symbols to 



copy file systems with 

provide 

chargeiee(IM) ckpacct(IM) dodisk(1M} 

Remote Terminal service 

set terminal type, modes, speed, and 

set terminal type, modes, speed, and 

set parallel 

unllnkflM) 

file system 

loadable driver name 

network 

debugger 



identifier 

Identify processss using a tile or , 
IDs and names „.....,.,.........,.„„ 



Ifita from sn ob|act file . 
image ............................ 

Imigss 
images .... 



.idioad(1M) 

newgrp(1M) 

......... pwck(1M) 

. shutdown^ M) 

, hinv{1M) 
, rfpasswd(IM) 
... dlskusg(lM) 
........ fstyp(1M) 

,fusar(1M) 
... ld(1M) 



.mkiflle(lM) 

. mem(7) 
...... crash(1M) 

.kcrash(IM) 



Information, copy In crash dump files . 

Initialization 

Initialization procedures 

l-nodo 

l-nodes 

Install commands 

install object files in binary 

Install software . 

interactive block copy 

Interface and control 

Interface cooperating STREAMS module 

interface . 

interface 

interface 

interface 

interface........................... „..„...„...,.„ 

Interface to do system administration 
Intsrfacs to STREAMS error logging 

interface 

Introduction to special files 

1-nombers 
inventory 



. diskutil(IM) 
.InltflM) 

. brc{1M) 
. clri(IM) 

, df(iM) 
.Install(IM) 
.cpset(IM) 

. ctins!all{1M} 

. bcopy{1M} 

. enei(7) 

, timod{?j 

. err(7) 

• Ip(7) 

......... scpa«7| 

.....swap(1M) 

...... termiof?) 

. sysadm(1M) 
. log(7) 
.... tty(7) 

, lntro{?J 



loctl commends 
Kernel Debug Monitor . 
kernel debugger 
kernel debugger . 

kill all active processes 

kmem(7) system memory image 

label checking . 



labels for file systems 

lastlogin(IM) monaect(fM) nulladm(iM) . 

limits administration 

line discipline 

line discipline 

line printer options 

link and unlink files and directories 

list file names and statistics for a 

list maintenance 



,ncheck(1M) 
.hlmi(1M) 
. streamioi?) 
. kdb(1M) 
, mkdbcmd(IM) 
. mkdbsymflMj 

„MHall(1M) 

mem(7) 

..volcopy(IM) 

labelit(1M) 

.... acctsh(IM) 

tslimit(IM) 

getty(IM) 

. uugetty(IM) 
,lpset(1M) 



. link(1M) 
. ff(1M) 



listener service administration ... 
load commands into the kernel 
load drivers , 



.. nmlmaint(IM) 
.. nlsadmin(IM) 
. mkdbcmd(IM) 
drvload(IM) 
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manage 

process a report of 

STREAMS error 

STREAMS error 

Interface to STREAMS error 

make a 

reject(1M) allow or prevent 

configure the 

lpshut(1M) 

loadable driver name list 



Remote File Sharing user and group 

update the 

kmem(7) system 

administration 

print STREAMS trace 

open any 

SCP active 

set terminal type, 

set terminal type, 

Interface cooperating STREAMS 

/ckpacct{1M) dodlsk(1M) lastlogin(1 M) 

Kernel Debug 

establish 

umountall(IM) 

display 

retry remote resource 

umountall(IM) mount, unmount 

run commands performed for 

administration 

print Remote File Sharing domain and 

of running process by changing 

Remote File Sharing 

the 

dodisk(1M) lastlogin(IM) monacct(IM) 

make an Htle from an 

Install 

driver 

run commands performed to stop the 

copy file systems for 

set parallel line printer 

sadc(1M) system activity report 
set 

change Remote File Sharing host 

grpck{1M) 

generate 



loadable device drivers .. — drivers(7) 

loadable driver name list maintenance nmlmalnt(IM) 

loadable drivers .. lddrv(1M) 

log In to a new group newgrp(1M) 

logged errors errpt(1M) 

logger cleanup program strclean(IM) 

logger daemon . „ — „ strerr{1M) 

logging and event tracing log(7) 

lost+found directory for fsck mklost+found(1M) 

LP requests accept(1M) 

LP spooling system Ipadmln(IM) 

lpmove(1 M) Ipsched(1 M) 

lpshut(1M) lpmove(1M) Ipsched(IM) 

maintenance ~™.„ nmlmaint{1 M) 

make a lost+found directory for fsck . mklost+found(1M) 

make an (file from an object file mkifile(IM) 

manage loadable drivers lddrv(1M) 

mapping „.„ idload(1 M) 

master file masterupd(1 M) 

memory image mem(7) 

menu interface to do system — ~ sysadm(1M) 

merge or add total accounting files acctmerg{1M) 

messages strace (1 M) 

minor device on a STREAMS driver clone(7) 

mode Interface scpa(7) 

modes, speed, and line discipline getty(1M) 

modes, speed, and line discipline uugetty(IM) 

module Transport . ~ tlmod{7) 

monacct(IM) nulladm(IM) acctsh(1M) 

Monitor kdb(1 M) 

mount table setmnt(1M) 

mount, unmount multiple file systems mountall(IM) 

mounted resource Information rmntstat(IM) 

mounts „ rmount(1 M) 

move a directory ........ . mvd!r(1M) 

multiple file systems mountall(IM) 

multi-user environment rc2(1M) 

network listener service nlsadmln(IM) 

network names dname(1M) 

nice alter priority renice(1M) 

notification shell script rfuadmln(IM) 

null file null(7) 

nulladm(IM) /ckpacct(IM) acctsh(1M) 

obiect file „ mkifile(IM) 

object files in binary directories cpset(1M) 

open any minor device on a STREAMS clone(7) 

operating system profiler prf(7) 

operating system rcO(1M) 

optimal access time . dcopy(1M) 

options Ipset{1 M) 

output system definition sysdef(1M) 

package sa1(1M) sa2(1M) .-. sar(1M) 

parallel line printer options lpset(1M) 

parallel printer interface Ip(7) 

password rfpasswd(1 M) 

password/group file checkers ~ pwck(1M) 

path names from i-numbers ncheck(1M) 
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environment run commands 

system run commands 

SCSI busses and 

check the uucp directories and 

procedures bcheckrc(IM) 

shutacct(IM) startup(IM)/ 

re]ect(1M) allow or 

prfld(1M) prfstat(IM) 

prfsnap(IM) prfpr(1M) 

prfstat(lM) prfdc(1M) prfsnap(IM) 

prfld(1M) prfstat(IM) prfdc(1M) 

prfpr(1M) prfld(1M) 

compare or 

network names 



parallel 

set parallel line 

changing nice alter 

acctprc1(1M) acctprc2(1M) 

alter priority of running 

telinit(IM) 

Remote File Sharing daemon 

kill all active 

structure Identify 

system 

disk access 

operating system 

disk access 

startup(1M)tumacct(1M) prdally(IM) 

Remote File Sharing name seiver 

read/write CMOS 

set up default values in CMOS 

uramdisk(7) 



requests 

advertise a directory for 

execute 

administration 

network names print 

stop the 

change 

shell script 

unadvertlse a 

start 

mapping 

retry 

try to contact 

administration 



performed for multi-user rc2(1M) 

performed to stop the operating rcO(1M) 

peripherals scsi(7) 

permissions file uucheck(IM) 

powerfail(IM) system initialization brc(1M) 

prdaily(IM) prtacct(IM) runacct(IM) prctmp(1M) 

prevent LP requests accept(1M) 

prfdc(1M) prfsnap(IM) prfpr(1M) profiler(IM) 

prfld(1M) prfstat(IM) prfdc(1M) profiler(IM) 

prfpr(1M) prfld(1M) profiler(IM) 

prfsnap(IM) prfpr(1M) profiler(IM) 

prfstat(IM) prfdc(1M) prfsnap(IM) profiler(IM) 

print out terminfo descriptions Infocmp(IM) 

print Remote File Sharing domain and dname(1M) 

print STREAMS trace messages strace(1M) 

print user and group IDs and names !d(1M) 

printer interface Ip(7) 

printer options IpsetflM) 

priority of running process by renice(1M) 

process a report of logged errors errpt(1M) 

process accounting acctprc(IM) 

process by changing nice renice(1M) 

process control initialization ........ „. init(1M) 

process rfudaemon(1 M) 

processes killall(1 M) 

processes using a file or file fuser(1M) 

profiler 6000/50 

profiler (usage (1 M) 

profiler prf(7) 

profiler ..... „ sadp(1 M) 

provide labels for file systems labelit(IM) 

prtacct(IM) runacct(1M)shutacct(1M) prctmp(1M) 

pseudo-device driver sxt(7) 

query nsquery(1 M) 

RAM cram(1 M) 

RAM cramsetup(1 M) 

RAM disk drivers ramdisk(7) 

read crash dump table .......... cdt(1M) 

read/write CMOS RAM crarn(1M) 

reboot the system reboot(1M) 

recover files from a backup tape frec(IM) 

reject(1M) allow or prevent LP accept(1M) 

remote access ....... .... adv(1M) 

remote command requests ... uuxqt(1M) 

Remote Rle Sharing daemon process .. rfudaemon(IM) 

Remote Rle Sharing domain . rtadmin(IM) 

Remote Rle Sharing domain and dname(1M) 

Remote Rle Sharing environment rfstop(lM) 

Remote Rle Sharing host password rrpasswd(IM) 

Remote Rle Sharing name server query .... nsquery(IM) 

Remote Rle Sharing notification riuadmin(IM) 

Remote Rle Sharing resource ......... ....... unadv(1M) 

Remote Rle Sharing rfstart(IM) 

Remote Rle Sharing user and group idload(1M) 

remote resource mounts .. rmount(IM) 

remote system with debugging on Uutry(1M) 

Remote Terminal service database tsdbadm(IM) 
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administration 

check a file system on a 

dfsck(1M! checka!l(1M5 check and 

l-nodes 

process a 

sa2(1M) sadc(IM) system activity 

re)ect(IM) allow or prevent LP 

execute remote command 

forced unmount of an advertised 

display mounted 

retry remote 

unadvertlse a Remote File Sharing 



Remote Terminal service limits 
removable disk 



.tslimlt(IM) 



repair file systems 

report file system status 

report number of free disk blocks and 

report of logged errors 

report package sa1(1M) 

requests , 



resource information , 
resource mounts — 



multi-user environment 
operating system 

tumacct(IM) prdaily(IM) prtacct(IM) 

alter priority of 

activity report package 

report package sa1(1M) 

package sa1(1M) sa2(1M) 

change the delta commentary of an 

check file system backup 

program the 

download code to active 

File Sharing notification shell 

configure devices on the 

Remote File Sharing name 

Remote File 

Remote File 

print Remote File 

stop the Remote File 

change Remote File 

Remote File 

Remote File 

unadvertlse a Remote File 

start Remote File 

Remote File 

Remote File Sharing notification 

halt(1M) 

prdaiiy(IM) prtacct(IM) runacct(IM) 

getgrpsSIM) install 

set terminal type, modes, 

set terminal type, modes, 

uucp 

configure the LP 

prtacct(IM) runacct(IM) shutacct(IM) 

list file names and 

report file system 

run commands performed to 

environment 



retry remote resource mounts . 
change root directory for a command ., 
rumountall(IM) 



run commands performed for 

run commands performed to stop the 
run daily accounting . 



runacct(IM) shutacct(IM) startup(IM) , 
running process by changing nice — 
sa1(1M) sa2(1M) sadc(1M) system ..... 
sa2(1M) sadc(1M) system activity . 
sadc(1M) system activity report 

SCCS delta 

schedule 



scheduler for the uucp file transport . 

SCP active mode interface ... 

SCP boards 



script Remote . 
SCSI bus 



SCSI busses and peripherals . 
server query . 



Sharing daemon process 

Sharing domain administration 

Sharing domain and network names 
Sharing environment ., 

Sharing host password 

Sharing name server query 

Sharing notification shell script , 

Sharing resource 

Sharing 



Sharing user and group mapping , 
shell script . 



. checkfsys(IM) 

fsck(1M) 

..fsstat(TM) 



. df(1M) 

. errpt(1Mj 

.... sar(IM) 

. accept{1M) 

-uuxqt(IM) 



.. fumounl(IM) 
... rmntstat(IM) 
.... rmount(1M) 

unadv(lM) 

.... rmountflM) 

chroot(1M) 

, nmountall(IM) 

rc2(1M) 

rcO(1M) 

.... runacct(IM) 

prctrnp(IM) 

renice(1M) 

sar(1M) 

.sar(1M) 
.sar(1M) 
. cdc(1M) 



, ckbupscd(IM) 



. uusched(IM) 
. scpa(7j 



... scpioctl(IM) 
. rfuadmin(IM) 
..scslcnfg(IM) 
. scsi(7) 



shut down system, change system state 
shutacct(IM) startup(IM) turnacct(IM) ... 



speed, and line discipline 
speed, and line discipline 
spool directory clean-up .. 
spooling system 



nsquery(1M| 

. rfudaemon(IM) 

rfadmln(lM) 

dname(1M) 

rfstopflM) 

.... rfpasswd(IM) 

...... nsquery(IM) 

.... rfuadmin{1 M) 

unadv(1M) 

rfstartflM) 

......... idload(1M) 

rfuadmin(IM) 

shutdown(IM) 
..... prctmp(1M) 
.... ctlnstall(IM) 
getty(1M) 



. uugetty(IM) 
. uucleanup(IM) 
,lpadmln(1M) 
. rfstart(IM) 



start Remote Rle Sharing rfstart(IM) 

siartup(IM) tumacct(IM) prdaily{1M) prctmp(1M) 

statistics for a file system ff(1M) 

status fsstat(l M) 

stop the operating system 

stop the Remote File Sharing 



. rcO(1M) 
. rfstop(1M) 



o 
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open any minor device on a 



tracing interface to 

Transport Interface cooperating 

print 

processes using a file or file 

update the 
become 

add 

halt(1M) shut down 

read crash dump 

establish mount 

recover files from a backup 

initialization 

general 

controlling 

administration Remote 

administration Remote 

discipline set 

discipline set 

virtual 



compare or print out 

copy file systems for optimal access 

merge or add 

print STREAMS 

to STREAMS error logging and event 

STREAMS module 

file 

the scheduler for the uucp file 

debugging on 

runacct(IM) shutacct(IM) startup(IM) 

discipline set terminal 

discipline set terminal 

file systems 

resource 

unlink(1M)llrkand 

directories 

umountall(IM) mount, 

forced 



summarize disk 

print 

Remote File Sharing 

generate disk accounting data by 

become super-user or another 

identify processes 

check the 

the scheduler for the 



STREAMS driver clone(7) 

STREAMS error logger cleanup program ... strelean(IM) 

STREAMS error logger daemon strerr(lM) 

STREAMS error logging and event iog(7) 

STREAMS loctl commands strearnio(7) 

STREAMS module timod(7) 

STREAMS trace messages strace(1M) 

structure identify fuser(1M) 

summarize disk usage du(1M) 

super block sync(1M) 

super-user or another user su(1M) 

swap administrative Interface swap(1M) 

symbols to kernel debugger mkdbsym(IM) 

system, change system state shutdown^ M) 

table.™ cdt(lM) 

table setmnt(1 M) 

tape frec(1 M) 

telinlt(IM) process control init(1M) 

terminal interface termio(7) 

terminal interface tty(7) 

Terminal service database tsdbadm(IM) 

Terminal service limits tslimit(IM) 

terminal type, modes, speed, and line getty(1M) 

terminal type, modes, speed, and line uugetty(IM) 

terminal vt(7) 

terminate the error-logging daemon errstop(1MJ 

terminfo compiler tic(1M) 

terminfo descriptions Infoemp(IM) 

time „ dcopy (1 M) 

total accounting files acctmerg(IM) 

trace messages strace(1M) 

tracing Interface log(7) 

Transport Interface cooperating timod(7) 

transport program for the uucp system ......... uuclco(1M) 

transport program .......... . . uusched(IM) 

try to contact remote system with Uutry(1M) 

tumacct(IM) prdaiiy(IM) prtaccK.1M) prctmp(1M) 

type, modes, speed, and line getty(IM) 

type, modes, speed, and line uugetty(IM) 

umount(1 M) mount(1 M) 

umountall(IM) mount, unmount multiple ... mountall(IM) 

unadvertise a Remote File Sharing unadv(1M) 

unlink files and directories llnk(1M) 

unlink(1M) link and unlink files and link(1M) 

unmount multiple file systems mountall(IM) 

unmount of an advertised resource fumount(IM) 

update the master file masterupd(IM) 

update the super block sync(1M) 

uramdiskfj] RAM disk drivers ramdisk(7) 

usage du(lM) 

user and group IDs and names id(1M) 

user and group mapping idload(1M) 

user ID diskusg(IM) 

user su(1M) 

using a file or file structure fuser(1MJ 

uucp directories and permissions file uucheck(IM) 

uucp file transport program uusched(IM) 
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uucp spool directory clean-up uucleanup(IM) 

file transport program for the uucp system uuclco(1M) 

set up default values in CMOS RAM cramsetup(IM) 

virtual terminal vt(7) 

who is doing what . .............. whodo(1M) 

who is doing what .... whodo(1M) 
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NAME 

intro - introduction to maintenance commands and application 
programs 

i^J: DESCRIPTION 

This section describes, in alphabetical order, commands that 
are used chiefly for system maintenance and administration 
purposes. The commands in this section should be used 
along with those listed in Section 1 of the User's Reference 
Manual and Sections 1, 2, 3, 4, and 5 of the Programmer's 
Reference Manual. References of the form name(1), (2), (3), 
(4) and (5) refer to entries in the above manuals. References 
of the form name (7) refer to entries in this manual. Refer- 
ences of the form name(#B) refer to entries in the U 6000 
Series NET-6000 Operations, Administration, and Programming 
Reference Manual. 

COMMAND SYNTAX 

Unless otherwise noted, commands described in this section 
accept options and other arguments according to the follow- 
^-.„ ing syntax: 

KJ name [ option (s) ] [ cmdarg(s) ] 

where: 

name is the name of an executable file. 

option - noargletter(s) or, 

- argletter< >optarg 

where < > is optional white space. 

noargletter is a single letter representing an option without 
an argument. 

argletter is a single letter representing an option requiring 
an argument. 

optarg is an argument (character string) satisfying the 

preceding argletter. 

cmdarg is a path name (or other command argument) 

f "" "•» nor beginning with - or, - by itself indicating the 

v_-/ standard input. 

SEE ALSO 

getopt(1) in the User's Reference Manual. 
getopt(3C) in the Programmer's Reference Manual. 
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DIAGNOSTICS 

Upon termination, each command returns two bytes of status, 
one supplied by the system and giving the cause for termina- 
tion, and (in the case of "normal" termination) one supplied by 
the program [see wait (2) and ex/f(2)]. The former byte is 
for normal termination; the latter is customarily for success- 
ful execution and non-zero to indicate troubles such as errone- 
ous parameters, bad or inaccessible data, or other inability to 
cope with the task at hand. It is called variously "exit code", 
"exit status", or "return code", and is described only where 
special conventions are involved. 

BUGS 

Regrettably, not all commands adhere to the aforementioned 
syntax. 



I } 
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NAME 

accept, reject - allow or prevent LP requests 

SYNOPSIS 
( /usr/lib/accept destinations 

/usr/iib/reject [ -r [ reason ] ] destinations 

DESCRIPTION 

Accept allows /p(1) to accept requests for the named destina- 
tions. A destination can be either a line printer (LP) or a class 
of printers. Use /psfa/(1) to find the status of destinations. 

Reject prevents /p(1) from accepting requests for the named 
destinations. A destination can be either a printer or a class 
of printers. Use /psfa/(1) to find the status of destinations. 
The following option is useful with reject. 

-r[ reason] Associates a reason with preventing /p from 
accepting requests. This reason applies to all 
printers mentioned up to the next -r option. 
Reason is reported by /p when users direct 
requests to the named destinations and by 
/psfaf(l). If the -r option is not present or the -r 
option is given without a reason, then a default 
reason will be used. 

FILES 

/usr/spool/lp/* 

SEE ALSO 

lpadmin(1M), lpsched(1M). 

enable(1), lp(1), lpstat(1) in the User's Reference Manual. 
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NAME 

acctdisk, acctdusg, accton, acctwtmp - overview of accounting 
and miscellaneous accounting commands 

SYNOPSIS 

/usr/lib/acct/acctdisk 

/usr/lib/acct/acctdusg [ -u file ] [ -p file ] 

/usr/lib/acct/accton [ file ] 

/usr/lib/acct/acctwtmp "reason" 

DESCRIPTION 

Accounting software is structured as a set of tools (consisting 
of both C programs and shell procedures) that can be used to 
build accounting systems. Acctsh (1M) describes the set of 
shell procedures built on top of the C programs. 

Connect time accounting is handled by various programs that 
write records into /etc/utmp/, as described in ufmp(4). The 
programs described in acctcon (1 M) convert this file into ses- 
sion and charging records, which are then summarized by 
acctmerg (1M). 

Process accounting is performed by the System V system ker- 
nel. Upon termination of a process, one record per process is 
written to a file (normally /usr/adm/pacct). The programs in 
acctprc (1M) summarize this data for charging purposes; 
acctcms^M) is used to summarize command usage. Current 
process data may be examined using acctcom{1). 

Process accounting and connect time accounting [or any 
accounting records in the format described in accr(4)] can be 
merged and summarized into total accounting records by 
acctmerg [see tacct format in accf(4)]. Prtacct [see 
acctsh (1M)] is used to format any or all accounting records. 

Acctdisk reads lines that contain user ID, login name, and 
number of disk blocks and converts them to total accounting 
records that can be merged with other accounting records. 

Acctdusg reads its standard input (usually from find I -print) 
and computes disk resource consumption (including indirect 
blocks) by login. If -u is given, records consisting of those file 
names for which acctdusg charges no one are placed in file (a 
potential source for finding users trying to avoid disk charges). 
If -p is given, file is the name of the password file. This option 
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is not needed if the password file is /etc/passwd. (See 
diskusg (1M) for more details.) 

Accton alone turns process accounting off. If file is given, it 
must be the name of an existing file, to which the kernel 
appends process accounting records [see accf(2) and 
acct(4)]. 

Acctwtmp writes a utmp(4) record to its standard output. The 
record contains the current time and a string of characters 
that describe the reason. A record type of ACCOUNTING is 
assigned [see utmp(A)]. Reason must be a string of 11 or 
fewer characters, numbers, $, or spaces. For example, the 
following are suggestions for use in reboot and shutdown pro- 
cedures, respectively: 

acctwtmp ^uname" » /etc/wtmp 
acctwtmp "file save" » /etc/wtmp 

FILES 

/etc/passwd used for login name to user ID conversions 

/usr/lib/acct holds all accounting commands listed in 

section 1 of this manual 

/usr/adm/pacct current process accounting file 

/etc/wtmp login/logoff history file 

SEE ALSO 

acctcms(IM), acctcon(IM), acctmerg(IM), acctprc(lM), 

acctsh(lM), diskusg(lM), runacct(IM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference 

Manual. 

acctcom(1) in the User's Reference Manual. 
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NAME 

acctcms - command summary from per-process accounting 
records 

SYNOPSIS 

/usr/lib/acct/acctcms [ options ] files 

DESCRIPTION 

Acctcms reads one or more files, normally in the form 
described in accf(4). It adds all records for processes that 
executed identically-named commands, sorts them, and writes 
them to the standard output, normally using an internal sum- 
mary format. The options are: 

-a Print output in ASCII rather than in the internal summary 
format. The output includes command name, number of 
times executed, total kcore-minutes, total CPU minutes, 
total real minutes, mean size (in K), mean CPU minutes 
per invocation, "hog factor", characters transferred, and 
blocks read and written, as in accfcom(1). Output is nor- 
mally sorted by total kcore-minutes. 

-c Sort by total CPU time, rather than total kcore-minutes. 

-j Combine all commands invoked only once under 
""•other". 

•n Sort by number of command invocations. 

-s Any file names encountered hereafter are already in inter- 
nal summary format. 

-t Process all records as total accounting records. The 
default internal summary format splits each field into 
prime and non- prime time parts. This option combines 
the prime and non- prime time parts into a single field that 
is the total of both, and provides upward compatibility 
with old style acctcms internal summary format records. 

The following options may be used only with the -a option. 

-p Output a prime-time-only command summary. 

-o Output a non-prime (offshift) time only command sum- 
mary. 

When -p and -o are used together, a combination prime and 
non-prime time report is produced. All the output summaries 
will be total usage except number of times executed, CPU 
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minutes, and real minutes, which will be split into prime and 
non- prime. 

A typical sequence for performing daily command accounting 
and for maintaining a running total is: 

acctcms file ... >today 

cp total previoustotal 

acctcms -s today previoustotal >total 

acctcms - a - s today 

SEE ALSO 

acct(lM), acctcon(IM), acctmerg(IM), acctprc(lM), 

acctsh(1M), runacct(IM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference 

Manual. 

acctcom(1),in the User's Reference Manual. 

BUGS 

Unpredictable output results if -t is used on new style internal 
summary format files, or if it is not used with old style internal 
summary format files. 
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NAME 

acctconl, acctcon2 - connect- time accounting 

SYNOPSIS 

/usr/iib/acct/acctcon1 [ options ] 

/usr/lib/acct/acctcon2 

DESCRIPTION 

Accfconf converts a sequence of login/logoff records read 
from its standard input to a sequence of records, one per 
login session. Its input should normally be redirected from 
/etc/wtmp. Its output is ASCII, giving device, user ID, login 
name, prime connect time (seconds), non-prime connect time 
(seconds), session starting time (numeric), and starting date 
and time. The options are: 

•p Print input only, showing line name, login name, and 
time (in both numeric and date/time formats). 

-t Acctconl maintains a list of lines on which users are 
logged in. When it reaches the end of its input, it 
emits a session record for each line that still appears to 
be active. It normally assumes that its input is a 
current file, so that it uses the current time as the end- 
ing time for each session still in progress. The -t flag 
causes it to use, instead, the last time found in its 
input, thus assuring reasonable and repeatable 
numbers for non-current files. 

-I file File is created to contain a summary of line usage 
showing line name, number of minutes used, percen- 
tage of total elapsed time used, number of sessions 
charged, number of logins, and number of logoffs. 
This file helps track line usage, identify bad lines, and 
find software and hardware oddities. Hang-up, termi- 
nation of tog/n(1) and termination of the login shell 
each generate logoff records, so that the number of 
logoffs is often three to four times the number of ses- 
sions. See init (1 M) and utmp (4) . 

-o file File is filled with an overall record for the accounting 
period, giving starting time, ending time, number of 
reboots, and number of date changes. 
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Acctcon2 expects as input a sequence of login session 
records and converts them into total accounting records [see 
tacct format in accf(4)]. 

EXAMPLES 

These commands are typically used as shown below. The file 
ctmp is created only for the use of acctprc (1M) commands: 

acctcoM - 1 - 1 1 ineuse - o reboots <wtmp i sort +1n +2 >ctmp 
acctcon2 <ctmp ' acctmerg >ctacct 

FILES 

/etc/wtmp 

SEE ALSO 

acct(1M), acctcms(IM), acctcom(1), acctmerg(IM), 
acctprc(IM), acctsh(1M), init(lM), login(1), runacct(IM). 
acct(2), acct(4), utmp(4) in the Programmer's Reference 
Manual. 

BUGS 

The line usage report is confused by date changes. 
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NAME 

acctmerg - merge or add total accounting files 

SYNOPSIS 

/usr/Iib/acct/acctmerg [ options ] [ file ] ... 

DESCRIPTION 

Acctmerg reads its standard input and up to nine additional 
files, all in the tacct format [see accf(4)], or an ASCII version 
thereof. It merges these inputs by adding records whose 
keys (normally user ID and name) are identical, and expects 
the inputs to be sorted on those keys. Options are: 

-a Produce output in ASCII version of tacct. 

-i Input files are in ASCII version of tacct. 

-p Print input with no processing. 

-t Produce a single record that totals all input. 

-u Summarize by user ID, rather than user ID and name. 

-v Produce output in verbose ASCII format, with more pre- 
cise notation for floating point numbers. 

EXAMPLES 

The following sequence is useful for making "repairs" to any 
file kept in this format: 

acctmerg -v <file1 >fi1e2 

edit file2 as desired . , . 

acctmerg -a <file2 >fi1e1 

SEE ALSO 

acct(1M), acctcms(IM), acctcom{1), acctcon(IM), acctprc(IM), 

acctsh(1M), runacct(IM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference 

Manual. 
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NAME 

acctprd , acctprc2 - process accounting 

^- SYNOPSIS 

\_/' /usr/lib/acct/acctprd [ ctmp ] 

/usr/lib/acct/acctprc2 

DESCRIPTION 

Acctprd reads input in the form described by accr(4), adds 
login names corresponding to user IDs, then writes for each 
process an ASCII line giving user IDs, login name, prime CPU 
time (tics), non-prime CPU time (tics), and mean memory size 
(in memory segment units). If ctmp is given, it is expected to 
contain a list of login sessions, in the form described in 
acctcon (1M), sorted by user ID and login name. If this file is 
not supplied, it obtains login names from the password file. 
The information in ctmp helps it distinguish among different 
login names that share the same user ID. 

Acctprc2 reads records in the form written by acctprd , sum- 

^ marizes them by user ID and name, then writes the sorted 

( ') summaries to the standard output as total accounting records. 

These commands are typically used as shown below. 

acctprd ctmp </usr/adm/pacct ! acctprc2 >ptacct 

FILES 

/etc/passwd 

SEE ALSO 

acct(1M), acctcms(IM), acctcom(1), acctcon (1M), 

acctmerg(IM), acctsh(1M), cron(1M), runacct(IM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference 

Manual. 

BUGS 

Although it is possible to distinguish among login names that 

share user IDs for commands run normally, it is difficult to do 

this for those commands run from cron (1M), for example. 

,•— x More precise conversion can be done by faking login sessions 

\^J on the console via the acctwtmp program in acct (1M). 

NOTE 

A memory segment of the mean memory size is a unit of 
measure for the number of bytes in a logical memory seg- 
ment on a particular processor. For example, on 80386-based 
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systems, such as the 6000/50, this measure would be in 4- 
kilobyte units. 



C ! 



Page 2 UP- 13529 



ACCTSH(IM) 



K. 



NAME 

chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, 
prctmp, prdaily, prtacct, runacct, shutacct, startup, turnacct - 
shell procedures for accounting 

SYNOPSIS 

/usr/lib/acct/chargefee login-name number 

/usr/lib/acct/ckpacct [blocks] 

/usr/lib/acct/dodisk [ -o ] [ files ... ] 

/usr/lib/acct/lastlogln 

/usr/lib/acct/monacct number 

/usr/lib/acct/nulladm file 

/usr/lib/acct/prctmp 

/usr/lib/acct/prdaily [ -I ] [ -c ] [ mmdd ] 

/usr/lib/acct/prtacct file [ "heading" ] 

/usr/lib/acct/runacct [ mmdd ] [ mmdd state ] 

/usr/lib/acct/shutacct [ "reason" ] 

/usr/lib/acct/startup 

/usr/lib/acct/turnacct on j off | switch 

DESCRIPTION 

Chargefee can be invoked to charge a number of units to 
login-name. A record is written to /usr/adm/fee, to be 
merged with other accounting records during the night. 

Ckpacct should be initiated via cron (1M). It periodically 
checks the size of /usr/adm/pacct. If the size exceeds 
blocks, 1000 by default, turnacct will be invoked with argu- 
ment switch. If the number of free 512-byte disk blocks in the 
/usr file system falls below 500, ckpacct will automatically turn 
off the collection of process accounting records via the off 
argument to turnacct. When at least this number of blocks is 
restored, the accounting will be activated again. This feature 
is sensitive to the frequency at which ckpacct is executed, 
usually by cron. 

Dodisk should be invoked by cron to perform the disk 
accounting functions. By default, it will do disk accounting on 
the special files in /etc/checklist. If the -o flag is used, it will 
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do a slower version of disk accounting by login directory. 
Files specify the one or more filesystem names where disk 
accounting will be done. If files are used, disk accounting will 
be done on these filesystems only. If the -o flag is used, files 
should be mount points of mounted filesystem. If omitted, 
they should be the special file names of mountable filesys- 
tems. 

Last login is invoked by runacct to update 
/usr/adm/acct/sum/loginlog, which shows the last date on 
which each person logged in. 

Monacct should be invoked once each month or each 
accounting period. Number indicates which month or period it 
is. If number is not given, it defaults to the current month 
(01-12). This default is useful if monacct is to executed via 
cron(1M) on the first day of each month. Monacct creates 
summary files in /usr/adm/acct/fiscal and restarts summary 
files in /usr/adm/acct/sum. 

Nulladm creates file with mode 664 and insures that owner 
and group are adm. It is called by various accounting shell 
procedures. 

Prctmp can be used to print the session record file (normally 
/usr/adm/acct/nite/ctmp created by acctconl [see 
acct con (1M)]. 

Prdaily is invoked by runacct to format a report of the previ- 
ous day's accounting data. The report resides in 
/usr/adm/acct/sum/rprtmmo'o' where mmdd is the month and 
day of the report. The current daily accounting reports may 
be printed by typing prdaily. Previous days' accounting 
reports can be printed by using the mmdd option and specify- 
ing the exact report date desired. The -I flag prints a report 
by login ID of exceptional usage for the specified date. Previ- 
ous daily reports are cleaned up and therefore inaccessible 
after each invocation of monacct. The -c flag prints a report 
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of exceptional resource usage by command and may be used 
on current day's accounting data only. 

Prtacct can be used to format and print any total accounting 
(tacct) file. 

Runacct performs the accumulation of connect, process, fee, 
and disk accounting on a daily basis. It also creates sum- 
maries of command usage. For more information, see 
runacct (1M). 

Shutacct should be invoked during a system shutdown (usu- 
ally in /etc/shutdown) to turn process accounting off and 
append a "reason" record to /etc/wtmp. 

The BACCT entries in the file /usr/spool/cron/crontabs/adm 
must be present to turn the accounting on whenever the sys- 
tem is brought up at run level 2. 

Turnacct is an interface to accton [see accf(lM)] to turn pro- 
cess accounting on or off. The switch argument turns 
accounting off, moves the current /usr/adm/pacct to the next 
free name in /usr/adm/pacct/ncr (where incr is a number 
starting with 1 and incrementing by one for each additional 
pacct file), then turns accounting back on again. This pro- 
cedure is called by ckpacct and thus can be taken care of by 
the cron and used to keep pacct to a reasonable size. 

FILES 

/usr/spool/cron/crontabs/adm 

cron file which determines the interval 
for system accounting 

/usr/adm/fee accumulator for fees 
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/usr/adm/pacct 
/usr/adm/pacct* 



current file for per-process accounting 

used if pacct gets large and during 
execution of daily accounting pro- 
cedure 



/etc/wtmp login/logoff summary 

/usr/lib/acct/ptelus.awk contains the limits for exceptional 

usage by login ID 

/usr/lib/acct/ptecms.awk 



/usr/adm/acct/nite 
/usr/lib/acct 



contains the limits for exceptional 
usage by command name 

working directory 

holds all accounting commands listed 
in section 1 of this manual 

summary directory, should be saved 



/usr/adm/acct/sum 

SEE ALSO 

acct(lM), acctcms(IM), acctcom(1), acctcon(IM), 

acctmerg(IM), acctprc(lM), cron(1M), diskusg(IM), 

runacct(lM). 

acct(2), acct(4), utmp(4) in the Programmer's Reference 

Manual. 
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NAME 

adv - advertise a directory for remote access 

SYNOPSIS 

adv [ -r ] [ -d description ] resource pathname 
[ clients ... ] 

adv -m resource -d description j [ clients ... ] 

adv -m resource [ -d description ] | clients ... 

adv 

DESCRIPTION 

Adv is the Remote File Sharing command used to make a 
resource from one computer available for use on other com- 
puters. The machine that advertises the resource is called the 
server, while computers that mount and use the resource are 
c//enfs. [See mount (1M).] (A resource represents a directory, 
which could contain files, subdirectories, named pipes, and 
devices.) 

There are three ways adv is used: (1) to advertise the direc- 
tory pathname under the name resource so it is available to 
Remote File Sharing clients; (2) to modify c//"enf and descrip- 
tion fields for currently advertised resources; or (3) to print a 
list of all locally-advertised resources. 

The following options are available: 

-r Restricts access to the resource to a read- 

only basis. The default is read-write access. 

-d description Provides brief textual information about the 
advertised resource, description is a single 
argument surrounded by double quotes (") 
and has a maximum length of 32 characters. 

resource This is the symbolic name used by the server 

and all authorized clients to identify the 
resource. It is limited to a maximum of 14 
characters and must be different from every 
other resource name in the domain. All char- 
acters must be printable ASCII characters but 
must not include periods (.), slashes (/), or 
white space. 
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pathname This is the local pathname of the advertised 

resource. It is limited to a maximum of 64 
characters. This pathname cannot be the 
mount point of a remote resource and it can 
only be advertised under one resource name. 

clients These are the names of all clients that are 

authorized to remotely mount the resource. 
The default is that all machines that can con- 
nect to the server are authorized to access 
the resource. Valid input is of the form 
nodename, domain.nodename , domain., or an 
alias that represents a list of client names. A 
domain name must be followed by a period (.) 
to distinguish it from a host name. The 
aliases are defined in /etc/host.alias and 
must conform to the alias capability in 
ma//x(1). 

-m resource This option modifies information for a 
resource that has already been advertised. 
The resource is identified by a resource name. 
Only the c//enfs and description fields can be 
modified. (To change the pathname, resource 
name, or read/write permissions, you must 
unadvertise and re-advertise the resource.) 

When used with no options, adv displays all local resources 
that have been advertised; this includes the resource name, 
the pathname, the description, the read-write status, and the 
list of authorized clients. The resource field has a fixed length 
of 14 characters; all others are of variable length. Fields are 
separated by two white spaces, double quotes (") surround 
the description, and blank lines separate each resource entry. 

This command may be used without options by any user; oth- 
erwise it is restricted to the super-user. 

Remote File Sharing must be running before adv can be used 
to advertise or modify a resource entry. 

EXIT STATUS 

If there is at least one syntactically valid entry in the clients 
field, a warning will be issued for each invalid entry and the 
command will return a successful exit status. A non-zero exit 
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status will be returned if the command fails. 

ERRORS 

If (1) the network is not up and running, (2) pathname is not a 
directory, (3) pathname isn't on a file system mounted locally, 
or (4) there is at least one entry in the clients field but none 
are syntactically valid, an error message will be sent to stan- 
dard error. 

FILES 

/etc/host.alias 

SEE ALSO 

mount(1M), rfstart(IM), unadv(1M). 
mailx(1) in the User's Reference Manual. 
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NAME 

bcopy - interactive block copy 

SYNOPSIS 

\ /etc/bcopy 

DESCRIPTION 

Bcopy copies from and to files starting at arbitrary block (512- 
byte) boundaries. 

Bcopy asks following questions: 

to: (you name the file or device to be copied to). 

offset: (you provide the starting "to" block number). 

from: (you name the file or device to be copied from). 

offset: (you provide the starting "from" block number). 

count: (you reply with the number of blocks to be 
copied). 

After count is exhausted, the from question is repeated (giv- 
ing you a chance to concatenate blocks at the 
( "\ to + offset + count location). If you answer from with a car- 

riage return, everything starts over. 

Two consecutive carriage returns terminate bcopy. 

SEE ALSO 

cpio(1), dd(l). 
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NAME 

brc, bcheckrc, powerfail - system initialization procedures 

SYNOPSIS 

/etc/brc 

/etc/bcheckrc 
/etc/powerfail 

DESCRIPTION 

These sheli procedures (except powerfail) axe executed via 
entries in /etc/bootwait (an entry in /etc/inittab) by /n/'f (1M) 
whenever the system is booted (or rebooted). They are exe- 
cuted at boot time. Powerfail is executed whenever a system 
power failure is detected. 

The bcheckrc procedure checks the status of the root file sys- 
tem. If the root file system is found to be bad, bcheckrc 
repairs it by calling /sc/c(1M). If fsck fails, bcheckrc switches 
the system to state 5, which is normally 6000/50 administrator 
mode. Bcheckrc also sets the date to the date currently in 
the real-time clock. 

The brc procedure clears the mounted file system table, 
/etc/mnttab, and puts the entry for the root file system into 
the mount table. 

The powerfail procedure is invoked when the system detects a 
power failure condition. It calls uadmin to bring down the sys- 
tem gracefully. 

After /etc/bootwait has been executed, init checks for the init- 
default value in /etc/inittab. This value tells init the run level 
in which to place the system. Since initdefault is initally set to 
2, the system will be placed in the multi-user state via the 
/etc/rc2 procedure. 

Note that bcheckrc should always be executed before brc. 
Also, these shell procedures may be used for several run level 
states. 



UP-13529 Page 1 



BRC(IM) 



SEE ALSO 

fsck(1M), hinv(1M), init(1M), rcO(1M), rc2(1M), shutdown (1M). 

date(1), who(1) in the User's Reference Manual. 

inittab(4), mnttab(4) in the Programmer's Reference Manual, 
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NAME 

captoinfo - convert a termcap description into a terminfo 
description 

SYNOPSIS 

captoinfo [ -v ... ] [ -1 ] [ -w width ] file ... 

DESCRIPTION 

Captoinfo looks in file tor termcap descriptions. For each one 
found, an equivalent terminfo (A) description is written to stan- 
dard output, along with any comments found. A description 
which is expressed as relative to another description (as speci- 
fied in the termcap tc = field) will be reduced to the minimum 
superset before being output. 

If no file is given, then the environment variable TERMCAP is 
used for the filename or entry. If TERMCAP is a full path- 
name to a file, only the terminal whose name is specified in 
the environment variable TERM is extracted from that file. If 
the environment variable TERMCAP is not set, then the file 
/etc/termcap is read. 

The options are as follows: 

-v Print tracing information on standard error as the pro- 
gram runs. Specifying additional -v options will cause 
more detailed information to be printed. 

-1 Cause the fields to print out one to a line. Otherwise, the 
fields will be printed several to a line to a maximum width 
of 60 characters. 

-w Change the output to width characters. 

FILES 

/usr/lib/terminfo/?/* compHed terminal description database 

CAVEATS 

Certain termcap defaults are assumed to be true. For exam- 
ple, the bell character (terminfo bel) is assumed to be "G. 
The linefeed capability (termcap nl) is assumed to be the 
same for both cursor_down and scroll Jorward (terminfo cudl 
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and ind, respectively.) Padding information is assumed to 
belong at the end of the string. 

The algorithm used to expand parameterized information for 
termcap fields such as cursor _position (termcap cm, terminfo 
cup) will sometimes produce a string which, though technically 
correct, may not be optimal. In particular, the rarely used 
termcap operation %n will produce strings that are especially 
long. Most occurrences of these non-optimal strings will be 
flagged with a warning message and may need to be recoded 
by hand. 

The short two-letter name at the beginning of the list of 
names in a termcap entry, a hold-over from an earlier version 
of the UNIX* system, has been removed. 

DIAGNOSTICS 

fgefenf failed with return code n (reason). 

The termcap entry is not valid. In particular, check for an 
invalid tc= entry. 

unknown type given for the termcap code cc. 

The termcap description had an entry for cc whose type 
was not boolean, numeric or string. 

wrong type given for the boolean (numeric, string) 
termcap code cc. 

The boolean termcap entry cc was entered as a numeric 

or string capability. 

the boolean (numeric, string) termcap code cc is 
not a valid name-. 

An unknown termcap code was specified. 

fgefenf failed on TERM = term. 

The terminal type specified could not be found in the 
termcap file. 



*UNIX is a registered trademark of AT&T in the USA and 
other countries. Portions of the Unisys System V Operating 
System are derived from the AT&T UNIX V.3 release. 
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TERM = term: cap cc (info ii) is NULL: REMOVED 

The termcap code was specified as a null string. The 

correct way to cancel an entry is with an @, as in :bs@:. 

( ") Giving a null string could cause incorrect assumptions to 

be made by the software which uses termcap or terminfo. 

a function key for cc was specified, but it already 

has the value vv. 

When parsing the ko capability, the key cc was specified 
as having the same value as the capability cc, but the key 
cc already had a value assigned to it. 

the unknown termcap name cc was specified in the ko 
termcap capability. 

A key was specified in the ko capability which could not 

be handled. 

the vi character v (info ii) has the value xx, 

but ma gives n. 

The ma capability specified a function key with a value dif- 
ferent from that specified in another setting of the same 
key. 

the unknown vi key v was specified in the ma 
termcap capability. 

A w(1) key unknown to captoinfo was specified in the ma 

capability. 

Warning: termcap sg (nn) and termcap ug (nn) had 
different values. 

Terminfo assumes that the sg (now xmc) and ug values 

were the same. 

Warning: the string produced for ii may be inefficient. 

The parameterized string being created should be rewrit- 
ten by hand. 

Null termname given. 

The terminal type was null. This is given if the environ- 
ment variable TERM is not set or is null. 

cannot open file for reading. 

The specified file could not be opened. 
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SEE ALSO 

infocmp(IM), tic(1M). 

curses(3X), terminfo(4) in the Programmer's Reference 

Manual. 

"curses/terminfo" in the System V Operating System 

Programmer's Guide. 

NOTES 

Captoinfo should be used to convert termcap entries to ter- 
minfo{4) entries because the termcap database (from earlier 
versions of UNIX System V) may not be supplied in future 
releases. 
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NAME 

cdc - change the delta commentary of an SCCS delta 

SYNOPSIS 

cdc -rSID [ -m [ mrlist ] ] [ -y [ comment ] ] files 

DESCRIPTION 

Cdc changes the delta commentary, for the SID (SCCS IDen- 
tification string) specified by the -r keyletter, of each named 
SCCS file. 

Delta commentary is defined to be the Modification Request 
(MR) and comment information normally specified via the 
de/fa(1) command (-m and -y keyletters). 

If a directory is named, cdc behaves as though each file in the 
directory were specified as a named file, except that non- 
SCCS files (last component of the path name does not begin 
with s.) and unreadable files are silently ignored. If a name 
of - is given, the standard input is read (see WARNINGS) and 
each line of the standard input is taken to be the name of an 
SCCS file to be processed. 

Arguments to cdc, which may appear in any order, consist of 
keyletter arguments and file names. 

All the described keyletter arguments apply independently to 
each named file: 

-rSID Used to specify the SCCS JDentification (SID) 

string of a delta for which the delta commen- 
tary is to be changed. 

-mmrlist If the SCCS file has the v flag set [see 

ao7r7/'n(1)] then a list of MR numbers to be 
added and/or deleted in the delta commen- 
tary of the SID specified by the -r keyletter 
may be supplied. A null MR list has no effect. 

MR entries are added to the list of MRs in the 

same manner as that of cte/fa(1). In order to 

delete an MR, precede the MR number with 

(' ) the character ! (see EXAMPLES). If the MR to 

be deleted is currently in the list of MRs, it is 
removed and changed into a "comment" line. 
A list of all deleted MRs is placed in the com- 
ment section of the delta commentary and 
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preceded by a comment line stating that they 
were deleted. 

If -m is not used and the standard input is a 
terminal, the prompt MRs? is issued on the 
standard output before the standard input is 
read; if the standard input is not a terminal, 
no prompt is issued. The MRs? prompt 
always precedes the comments? prompt (see 
-y keyletter). 

MRs in a list are separated by blanks and/or 
tab characters. An unescaped new-line char- 
acter terminates the MR list. 

Note that if the v flag has a value [see 
admin {1)], it is taken to be the name of a pro- 
gram (or shell procedure) which validates the 
correctness of the MR numbers. If a non-zero 
exit status is returned from the MR number 
validation program, cdc terminates and the 
delta commentary remains unchanged. 

-y [comment] Arbitrary text used to replace the comment (s) 
already existing for the delta specified by the 
-r keyletter. The previous comments are kept 
and preceded by a comment line stating that 
they were changed. A null comment has no 
effect. 

If -y is not specified and the standard input is 
a terminal, the prompt comments? is issued 
on the standard output before the standard 
input is read; if the standard input is not a ter- 
minal, no prompt is issued. An unescaped 
new-line character terminates the comment 
text. 

Simply stated, the keyletter arguments are either (1) if you 
. made the delta, you can change its delta commentary; or (2) 
if you own the file and directory you can modify the delta 
commentary. 

EXAMPLES 

cdc -N.6 -m"bl78- 12345 !bl77- 54321 bl79- 00001" -ytrouble 
s.file 
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Adds bl78- 12345 and bl79-00001 to the MR list, removes bl77- 
54321 from the MR list, and adds the comment trouble to 
delta 1 .6 of s.file. 

cdc -r1.6 s.file 

MRs? !b1 77- 54321 bl 78- 12345 bl 79- 00001 

comments? trouble 

does the same thing. 

WARNINGS 

If SCCS file names are supplied to the cdc command via the 
standard input (- on the command line), then the -m and -y 
keyletters must also be used. 

FILES 

x-file [seede/fa(1)] 

z-file [seede/fa(1)] 

SEE ALSO 

admin(l), delta(1), get(1), prs(1), sccsfile(4). 
help(1) in the User's Reference Manual. 

DIAGNOSTICS 

Use he/p(1) for explanations. 
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NAME 

cdt - read crash dump table 

SYNOPSIS 

cdt [ -bBdDprav ] 

DESCRIPTION 

Reads the crash dump table set up by the boot ROM, and 
displays various parts of it, as specified by the command line 
options, 

-b Print the drive number of the boot device, as a decimal 
integer, 

-d Print the drive number of the dump device, as a decimal 
integer. 

-B Print the media type of the boot device. The media type 
is a single character: S (SCSI disk), T (tape), D (ST506 
disk), F (floppy). 

•D Print the media type of the dump device. 

-p Print the panic string, if the system went down due to a 
panic. 

-r Print the reason for the previous shutdown. This is actu- 
ally a brief history of the events starting from the previous 
poweron. 

-a Equivalent to -BbDdrp. 

-v Verbose mode. Prints descriptive text for each of the 
items displayed. 
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NAME 

checkfsys - check a file system on a removable disk 

SYNOPSIS 

The checkfsys command allows the user to check for and 
optionally repair a damaged file system on a removable 
disk. 

The user is asked one of the following three functions: 

check the file system 

No repairs are attempted. 

repair it interactively 

The user is informed about each instance of damage and 
asked if it should be repaired. 

repair it automatically 

The program applies a standard repair to each instance of 
damage. 

WARNING 

While automatic and interactive checks are generally success- 
ful, they can occasionally lose a file or a ? file's name. Files with 
content but without names are put in the /file- 
sysfem/lost-r found directory. 

If losing data is of particular concern, "check" the file system 
first to discover if it appears to be damaged. If it is damaged, 
use one of the repair mechanisms or the file system debug- 
ging utility, fsdb. 

SEE ALSO 

fsck(1M), fsdb(lM). 
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NAME 

chroot - change root directory for a command 

SYNOPSIS 

/etc/chroot newroot command 

DESCRIPTION 

Chroot causes the given command to be executed relative to 
the new root. The meaning of any initial slashes (/) in the 
path names is changed for the command and any of its child 
processes to newroot. Furthermore, upon execution, the ini- 
tial working directory is newroot. 

Notice, however, that if you redirect the output of the com- 
mand to a file: 

chroot newroot command >x 

will create the file x relative to the original root of the com- 
mand, not the new one. 

The new root path name is always relative to the current root: 
even if a chroot is currently in effect, the newroot argument is 
relative to the current root of the running process. 

This command can be run only by the super-user. 

SEE ALSO 

cd(1) in the User's Reference Manual. 

chroot(2) in the Programmer's Reference Manual. 

BUGS 

One should exercise extreme caution when referencing device 
files in the new root file system. 
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NAME 

ckbupscd - check file system backup schedule 

SYNOPSIS 

f A 

l j /etc/ckbupscd [ -m ] 

DESCRIPTION 

Ckbupscd consults the file /etc/bupsched and prints the file 
system lists from lines with date and time specifications 
matching the current time. If the -m flag is present an intro- 
ductory message in the output is suppressed so that only the 
file system lists are printed. Entries in the /etc/bupsched file 
are printed under the control of cron. 

The System Administration commands bupsched/ schedcheck 
are provided to review and edit the /etc/bupsched file. 

The file /etc/bupsched should contain lines of 4 or more 
fields, separated by spaces or tabs. The first 3 fields (the 
schedule fields) specify a range of dates and times. The rest 
of the fields constitute a list of names of file systems to be 
printed if ckbupscd is run at some time within the range given 
by the schedule fields. The general format is: 

time[,time] day[,day] month[, month] fsyslist 

where: 

time Specifies an hour of the day (0 through 23), match- 

ing any time within that hour, or an exact time of 
day (0:00 through 23:59). 

day Specifies a day of the week (sun through sat) or 

day of the month (1 through 31). 

month Specifies the month in which the time and day 
fields are valid. Legal values are the month 
numbers (1 through 12). 

fsyslist The rest of the line is taken to be a file system list 
to print. 

Multiple time, day, and month specifications may be 
separated by commas, in which case they are evaluated left to 
right. 

An asterisk (*) always matches the current value for that field. 
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A line beginning with a sharp sign (#) is interpreted as a com- 
ment and ignored. 

The longest line allowed (including continuations) is 1024 char- 
acters. 

EXAMPLES 

The following are examples of lines which could appear in the 
/etc/bupsched file. 

06:00-09:00 fri 1,2,3,<»,5,6,7,8,9,10,11 /applic 

Prints the file system name /applic if ckbupscd is run between 
6:00am and 9:00am any Friday during any month except 
December. 

00:00-06:00,16:00-23:59 1,2,3,1,5,6,7 1,8 / 

Prints a reminder to backup the root (/) file system if 
ckbupscd is run between the times of 4:00pm and 6:00am 
during the first week of August or January. 

FILES 

/etc/bupsched specification file containing times and file 

system to back up 

SEE ALSO 

cron(1M). 

echo(1), sh(1), sysadm(1) in the User's Reference Manual. 

BUGS 

Ckbupscd will report file systems due for backup if invoked 
any time in the window. It does not know that backups may 
have just been taken. 
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NAME 

clri - clear i-node 

SYNOPSIS 

/etc/clri special i-number ... 

DESCRIPTION 

Clri writes nulls on the 64 bytes at offset i-number from the 
start of the i-node list. This effectively eliminates the i-node at 
that address. Special is the device name on which a file sys- 
tem has been defined. After clri is executed, any blocks in the 
affected file will show up as "not accounted for" when 
fsc/c(1M) is run against the file-system. The i-node may be 
allocated to a new file. 

Read and write permission is required on the specified special 
device. 

This command is used to remove a file which appears in no 
directory; that is, to get rid of a file which cannot be removed 
with the rm command. 

SEE ALSO 

fsck(1M), fsdb(1M), ncheck(lM). 

fs(4) in the Programmer's Reference Manual. 

rm(1) in the User's Reference Manual. 

WARNINGS 

If the file is open for writing, clri will not work. The file system 
containing the file should be NOT mounted. 

If clri is used on the i-node number of a file that does appear 
in a directory, it is imperative to remove the entry in the direc- 
tory at once, since the i-node may be allocated to a new file. 
The old directory entry, if not removed, continues to point to 
the same file. This sounds like a link, but does not work like 
one. Removing the old entry destroys the new file. 
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NAME 

config - configure a 6000/50 system 

SYNOPSIS 

/etc/config [ -c file ] [ -h file ] [ -m file ] dfile 

DESCRIPTION 

Config is a program that takes a description of a 6000/50 sys- 
tem, generates a configuration table file, and generates a 
hardware interface file. The configuration table file is a C pro- 
gram defining the configuration tables for the various devices 
on the system. The hardware interface file provides informa- 
tion regarding the interface between the hardware and device 
handlers. 

The options are as follows: 

'Cfile Specifies the name of the configuration table file; 
conf.c is the default name. 

-h file Specifies the name of the configuration header file', 
config. h is the default. 

-m file Specifies the name of the file that contains all the 
information regarding supported devices; 
/etc/master is the default name. This file is sup- 
plied with the 6000/50 system and should nor be 
modified unless the user fully understands its con- 
struction. 

The user must supply df;7e; it must contain device information 
for the user's system. This file is divided into two parts. The 
first part contains physical device specifications. The second 
part contains system-dependent information. Any line with an 
asterisk (*) in column 1 is a comment. 

First Part of dfile 
Each line contains one field: 

devname 

where devname is the name of the device (as it appears in the 
/etc/master device table). 

Second Part of dfile 

The second part contains two different types of lines. Note 
that all specifications of this part are required, although their 
order is arbitrary. 

UP-13529 . Page 1 



CONFIG (1M) 



1 . Root/pipe/swap device specification 
Three lines of three fields each: 



root 


devname 


minor 








pipe 


devname 


minor 








swap 


devname 


minor 








where minor is the minor 


device number 


(in 


decimal) 


of 


the slice on 


the fixed disk. 











2. Parameter specification 

There are any number of lines of two fields each, chosen 
from the following list. Number is decimal. This list is not 
complete; parameters not on the list either must not be 
changed or have no effect. 



maxusers 



buffers number 

dmmxsz 

I nodes 

files number 

nf locks number 

mounts number 

regions number 

procs number 

maxproc number 

maxfsiz number 

maxumem number 



number 

/* maximum number of users logged */ 
/* on at any one time */ 
/* number of 1021-byte file */ 
/* system caching buffers */ 

number /* maximum number of pages */ 
/* per loadable driver */ 

number 

/* maximum open i- nodes in system */ 



/* maximum open files in system */ 

/* maximum locks active in system */ 

/* maximum file systems mounted */ 

/* total number of regions in */ 

/* system */ 

/* maximum processes in system */ 

/* maximum processes per user ID */ 

/* ulimit default in 512-byte */ 

/* blocks */ 

/* maximum number of pages per */ 

/* process */ 
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cbufsize number 



f 



cl ists 

msgmax 

msgmni 

msgmnb 

msgtql 
msgssz 
msgseq 
nlddrv 

semmni 
sennmns 

semmsi 
semopm 

semume 

semmnu 

shmmax 

shirmin 

shmmni 

shmseg 



/* console circular buffer size in */ 

/* bytes */ 
number /* number of 64- byte character */ 

/* buffers */ 
number 

/* maximum characters in a message */ 
number 

/* maximum active message queues */ 
number /* maximum total characters in */ 

/* message queues */ 
number /* maximum messages in system */ 
number /* msgssz * msgseq = number of */ 
number /* bytes of system buffering */ 
number /* maximum number of loadable */ 

/* drivers */ 
number /* maximum active semaphores */ 
number 

/* maximum semaphores in system */ 
number /* maximum semaphores per ID */ 
number /* maximum operations per semop */ 

/* call */ 
number /* maximum undo structures per */ 



/* process */ 



number 



/* maximum undo structures in */ 

/* system */ 
number /* maximum bytes in a shared */ 

/* segment */ 
number /* minimum bytes in a shared */ 

/* segment */ 
number 

/* maximum active shared segments */ 
number 
/* maximum attached segments per */ 



/""" 



sysname "string" /* default system name */ 
nodename "string" /* default node name */ 

Certain parameters if set to will allow the kernel to auto- 
configure. Max users, processes, regions, i-nodes, files, 
and buffers are autoconfigurable. The number of users is 
based on the amount of physical memory; the number of 
processes is based on the number of users; regions, i- 
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nodes, and files are based on the number of processes. 
The number of buffers is based on the amount of physical 
memory. Any or all of these may be overridden. 

EXAMPLE 

To configure a system with the following devices: 

Onboard quarter-inch' tape 

Onboard SCSI disks 

RS-232-C (any number of ports) 

One parallel line printer 

Root device is a fixed disk (drive 0, section 1) 

Pipe device is a fixed disk (drive 0, section 1) 

Swap device is a fixed disk (drive 0, section 2) 

Number of buffers is 100 

Number of processes is 100 

Maximum number of processes per user ID is 25 

Number of mounts is 6 

Number of i-nodes is 100 

Number of files is 120 

Number of character buffers is 64 

The actual system configuration would be specified as follows: 



diskonbd 




serial 




qic 




console 




pip 




root diskonbd 


01 


pipe diskonbd 


01 


swap diskonbd 


02 


* Comnents may 


be inserted in this manner 


buffers 100 




procs 


100 


maxproc 25 




mounts 


6 


i nodes 


100 


files 


120 


clists 


61 


ES 

/etc/master default input master device 1 
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config.h default output configuration header file 

conf.c default output configuration table file 

SEE ALSO 

master(4) in the Programmer's Reference Manual. 

DIAGNOSTICS 

Diagnostics are routed to the standard output and are self- 
explanatory. 
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NAME 

cons - control of system console 

_ SYNOPSIS 

V ! cons [ -o output ] [ -i input ] [ -I ] [ -c char ] [ -I lines ] 

[ -p [ +-= ] letters ] [ -f [ +-= ] be ] [ -F ] [ -s ] 

DESCRIPTION 

Cons is used to control the functions of the system console. 
The system console is used for display of kernel diagnostics 
as well as input and output of the kernel debugger (if loaded). 
Use of this command to change parameters is restricted to 
the super-user, although anyone may invoke it merely to 
report the current parameters. 

OPTIONS 

-o Followed by the name of a tty device {output), causes the 
specified tty to be used for display of kernel diagnostics. 

-i Followed by the name of a tty device (input), causes the 

specified tty to be used as the input device for the con- 

^ sole break character. When the console break character 

f ) is typed on the specified tty, the kernel will break into the 

kernel debugger. 

-I Specifies that any tty may be used as the input device. In 
other words, the kernel debugger will be entered when 
the console break character is typed on any tty. 

-c Followed by a character char, specifies the console break 
character. The default is control-B. The character may be 
specified as a single character, a character preceded by a 
carat (to indicate a control character), or an octal value 
preceded by a backslash. 

-I Followed by an integer, will cause kernel diagnostics to 
pause after that many lines, until a character is typed. A 
value of zero disables this feature. The default is zero. 

-p Changes the level of kernel diagnostics. There are 32 lev- 
els of diagnostics, each identified by a letter from a-z and 

f~~") A-F. Each level may be individually enabled or disabled. 

x — / " If the -p is followed by a plus sign and a list of letters, 

those levels are enabled. If the -p is followed by a minus 
sign and a list of letters, those levels are disabled. If the - 
p is followed by two minus signs, all diagnostics are 
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disabled. If the -p is followed by an equals sign and a list 
of letters, exactly those levels are enabled and all other 
levels are disabled. More than one -p option may be 
specified. 

-f Changes the handling of all kernel diagnostics. By 
default, diagnostics go to the system console as well as to 
a buffer where they can be read by the system error 
demon [see errdemon(IM)]. The two flag letters c and b 
enable the outputting of diagnostics to the console and 
the buffer respectively. Thus -f-c stops diagnostics from 
going to the console. 

-F Causes the kernel diagnostics which are currently in the 
buffer to be flushed to the error daemon. Normally, the 
diagnostics remain in the buffer until the buffer is nearly 
full, at which time they are flushed to the daemon. 

-s Normally, when cons is finished, it prints a description of 
the current settings of all console parameters. The -s flag 
suppresses this printing. 

Cons with no parameters simply prints the current parameters 
without changing anything. 



Page 2 UP-13529 



CPSET(IM) 



NAME 

cpset - install object files in binary directories 

SYNOPSIS 

cpset [ -o ] object directory [ mode owner group ] 

DESCRIPTION 

Cpset is used to install the specified object file in the given 
directory. The mode, owner, and group of the destination file 
may be specified on the command line. If this data is omitted, 
two results are possible: 

• If the user of cpsef has administrative permissions (that 
is, the user's numerical ID is less than 100), the following 
defaults are provided: 

mode - 0755 

owner - bin 

group - bin 

• If the user is not an administrator, the default, owner, and 
group of the destination file will be that of the invoker. 

An optional argument of -o will force cpsef to move object to 
OLDob/ecf in the destination directory before installing the 
new object. 

For example: 

cpset echo /bin 0755 bin bin 

cpset echo /bin 

cpset echo /bin/echo 

All the examples above have the same effect (assuming the 
user is an administrator). The file echo will be copied into /bin 
and will be given 0755, bin, and bin as the mode, owner, and 
group, respectively. 

Cpset utilizes the file /usr/src/destinations to determine the 
final destination of a file. The locations file contains pairs of 
pathnames separated by spaces or tabs. The first name is 
the "official" destination (for example: /bin/echo). The 
second name is the new destination. For example, if echo is 
moved from /bin to /usr/bin, the entry in 
/usr/src/destinations would be: 
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/bin/echo /usr/bin/echo 

When the actual installation happens, cpset verifies that the 
"old" pathname does not exist. If a file exists at that location, 
cpset issues a warning and continues. This file does not exist 
on a distribution tape; it is used by sites to track local com- 
mand movement. The procedures used to build the source 
are responsible for defining the "official" locations of the 
source. 

Cross Generation 

The environment variable ROOT will be used to locate the des- 
tination file (in the form $ROOT/usr/src/destinations). This is 
necessary in the cases where cross generation is being done 
on a production system. 

SEE ALSO 

install(IM). 

make(1) in the Programmer's Reference Manual. 
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NAME 

cram - read/write CMOS RAM 

SYNOPSIS 

cram -r addr 

cram -w addr value 

DESCRIPTION 

Cram reads or writes a single byte to or from the CMOS RAM. 
The 6000/50 has 64 bytes of CMOS RAM, most of which are 
used at boot time by the boot ROM. The first form of the 
command reads the byte at the given address addr, which 
should be a decimal number between and 63, and prints the 
byte read as a decimal integer on the standard output. The 
second form of the command writes the byte at the given 
address addr with the given value, which should be a decimal 
number between and 255. You must have superuser 
privileges to run the second form of the command. 

FILES 

/dev/cram 

SEE ALSO 

cramsetup(IM). 

U 6000 Series Technical Reference Manual, 
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NAME 

cramsetup - set up default values in CMOS RAM 

SYNOPSIS 
{ ) cramsetup fltype f2type 

DESCRIPTION 

Cramsetup sets up default parameters in the CMOS RAM. 
this allows 6000/50 to boot without having to run the Setup 
function of the 6000/50 Diagnostics. Ftfype and f2type are 
integers specifying the type for the first and second floppy 
disk drives on the system. The supported types are as fol- 
lows: 

- no drive present 

1 - 360KB 5.25 inch drive 

2 - 1.2MB 5.25 inch drive 

3 - 720KB 3.5 inch drive 

4 - 1.44MB 3.5 inch drive 

Both parameters must be present. In addition to making the 
floppy disk types available to System V, several other parame- 
; ters are initialized, and the hard disk parameters for MS-DOS 

^^ diskettes are set to 0, indicating that no MS-DOS hard disks 

are available. Base memory is set at 640KB. Extended 
memory is computed and initialized. The installed equipment 
byte is set up with the number of floppy drives configured and 
with no display adapter present. The diagnostic status is 
cleared. Finally, the checksum for the CMOS RAM is updated. 

These initialization steps are taken to bring the CMOS RAM to 
a state that is recognized as acceptable to the ROM based 
boot routines. As a result, the 6000/50 subsequently boots 
without a configuration error and a message to run Setup 
from the Diagnostics diskette. 

EXAMPLE 

To initialize the CMOS RAM and configure the system for one 
1.2MB 5.25 inch floppy drive: 

/- ■-, /etc/cramsetup 2 

O WARNING 

This utility is intended for a system in which only System V will 
be booted. If the system is to be configured so that MS-DOS 
is booted, then the Setup utility from the Diagnostics should 
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be run instead of cramsetup. 

SEE ALSO 

cram(1M). 
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NAME 

crash - examine system images 

f-^ SYNOPSIS 

V_^ /etc/crash [ -d dumpfile ] [ -n namelist ] [ -w outputfile ] 

DESCRIPTION 

The crash command is used to examine the system memory 
image of a live or a crashed system by formatting and printing 
control structures, tables, and other information. Command 
line arguments to crash are dumpfile, namelist, and outputfile. 

Dumpfile is the file containing the system memory image, and 
can be /dev/mem, a regular file, or partition of the root disk, 
which always contains the system image of the last panic. 
The default dumpfile is /dev/mem. 

The text file namelist contains the symbol table information 
needed for symbolic access to the system memory image to 
be examined. The default namelist is lunix. If a system image 
from another machine is to be examined, the corresponding 
^ text file must be copied from that machine. 

\J When the crash command is invoked, a session is initiated. 

The output from a crash session is directed to outputfile. The 
default outputfile is the standard output. 

Input during a crash session is of the form: 

function [ argument ... ] 

where function is one of the crash functions described under 
"FUNCTIONS" below, and arguments are qualifying data that 
indicate which items of the system image are to be printed. 

The default for process-related items is the current process for 
a running system and the process that was running at the 
time of the crash for a crashed system. If the contents of a 
table are being dumped, the default is all active table entries. 

The following function options are available to crash functions 
wherever they are semantically valid. 

o 



UP-13529 Page 1 



CRASH(IM) 



-e Display every entry in a table. 

-f Display the full structure. 

-p Interpret all address arguments in the command 

line as physical addresses. 

-s process Specify a process slot other than the default. 

-w file Redirect the output of a function to file. 

Note that if the -p option is used, all address and symbol 
arguments explicitly entered on the command line will be inter- 
preted as physical addresses. If they are not physical 
addresses, results will be inconsistent. 

The functions mode, defproc, and redirect correspond to the 
function options -p, -s, and -w. The mode function may be 
used to set the address translation mode to physical or virtual 
for all subsequently entered functions; defproc sets the value 
of the process slot argument for subsequent functions; and 
redirect redirects all subsequent output. 

Output from crash functions may be piped to another pro- 
gram in the following way: 

function [ argument . . . ] ! shell_command 

For example, 

mount l grep rw 

will write all mount table entries with an rw flag to the stan- 
dard output. The redirection option (-w) cannot be used with 
this feature. 

Depending on the context of the function, numeric arguments 
will be assumed to be in a specific radix. Counts are assumed 
to be decimal. Addresses are always hexadecimal. Table 
address arguments larger than the size of the function table 
will be interpreted as hexadecimal addresses; those smaller 
will be assumed to be decimal slots in the table. Default bases 
on all arguments may be overridden. The C conventions for 
designating the bases of numbers are recognized: A number 
that is usually interpreted as decimal will be interpreted as 
hexadecimal if it is preceded by Ox and as octal if it is pre- 
ceded by 0. Decimal override is designated by Od, and binary 
by Ob. 
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Aliases for functions may be any uniquely identifiable initial 
substring of the function name. Traditional aliases of one 
letter, such as p for proc, remain valid. 

Many functions accept different forms of entry for the same 
argument. Requests for table information will accept a table 
entry number, a physical address, a virtual address, a symbol, 
a range, or an expression. A range of slot numbers may be 
specified in the form a-b where a and b are decimal numbers. 
An expression consists of two operands and an operator. An 
operand may be an address, a symbol, or a number; the 
operator may be +, -, *, /, &, or |. An operand which is a 
number should be preceded by a radix prefix if it is not a 
decimal number (0 for octal, Ox for hexidecimal, Ob for binary). 
The expression must be enclosed in parentheses (). Other 
functions will accept any of these argument forms that are 
meaningful. 

Two abbreviated arguments to crash functions are used 
throughout. Both accept data entered in several forms. They 
may be expanded into the following: 

table_entry = table entry J address J symbol ] range 
j expression 

start_addr = address | symbol j expression 

FUNCTIONS 

? [ -w file ] 

List available functions. 

!cmd 

Escape to the shell to execute a command. 



adv [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the advertise table. 
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base [ -w file ] number . . . 

Print number in binary, octal, decimal, and hexadecimal. A 
number in a radix other then decimal should be preceded 
by a prefix that indicates its radix as follows: Ox, hexide- 
cimal; 0, octal; and Ob, binary. 

buffer [ -w file ] [ -format ] bufferslot 

or 

buffer [ -w file ] [ -format ] [ -p ] start_addr 
Alias: b. 

Print the contents of a buffer in the designated format. 
The following format designations are recognized: -b, 
byte: -c, character; -d, decimal; -x, hexadecimal; -o, octal; 
-r, directory; and -i, i-node. If no format is given, the pre- 
vious format is used. The default format at the beginning 
of a crash session is hexadecimal. 

bufhdr [ -f ] t -w file 1 [ [ -p ] table_entry . . . ] 
Alias: buf. 
Print system buffer headers. 

callout [ -w file ] 
Alias: c. 
Print the callout table. 

dballoc [ -w file ] [ class . . . ] 

Print the dballoc table. If a class is entered, only data 
block allocation information for that class will be printed. 

dbfree [ -w file ] [ class . . . ] 

Print free streams data block headers. If a class is 
entered, only data block headers for the class specified 
will be printed. 



Page 4 UP- 13529 



CRASH (1M) 



dblock [ -e ] [ -w file ] [ -c class . . . ] 

or 

/"\ dblock [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 

K^J Print allocated streams data block headers. If the class 

option (-c) is used, only data block headers for the class 

specified will be printed. 

defproc [ -w file ] [ -c ] 

or 

defproc [ -w file ] [ slot ] 

Set the value of the process slot argument. The process 
slot argument may be set to the current slot number (-c) 
or the slot number may be specified. If no argument is 
entered, the value of the previously set slot number is 
printed. At the start of a crash session, the process slot 
is set to the current process. 

dis [ -w file ] [ -a ] start_addr [ count ] 

Disassemble from the start address for count instructions. 
The default count is 1. The absolute option (-a) specifies 
\^J a non-symbolic disassembly. 

ds [ -w file ] virtual_address . . . 

Print the data symbol whose address is closest to, but not 
greater than, the address entered. 

file [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Alias: f. 
Print the file table. 

findaddr [ -w file ] table slot 

Print the address of slot in table. Only tables available to 
the size function are available to findaddr. 

findslot [ -w file ] virtual_address . . . 

Print the table, entry slot number, and offset for the 
address entered. Only tables available to the size func- 
tion are available to findslot. 

f") fs [ -w file ) [ [ -p ] table_entry . . . ] 

x -~ "' Print the file system information table. 

gdp [ -e ] [ -f ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the gift descriptor protocol table. 
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gdt [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the global descriptor table. 

help [ -w file ] function . . . 

Print a description of the named function, including syn- 
tax and aliases. 

idt [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the global descriptor table. 

inode [ -e ] [ -f ] [ -w file ] [ [ -p ] table_entry . . . ] 
Alias: i. 

Print the i-node table, including file system switch infor- 
mation. 

kfp [ -w file ] [ value ] 

Print the frame pointer for the start of a kernel stack 
trace. If the value argument is supplied, the kfp is set to 
that value. 

Ick [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Alias: I. 

Print record locking information. If the -e option is used or 
table address arguments are given, the record lock list is 
printed. If no argument is entered, information on locks 
relative to i-nodes is printed. 

Idt [ -e ] [ -w file f[ -s process ] [ [ -p ] table_entry . . . ] 

Print the local descriptor table for the given process, or 
for the current process if none is given. 

linkblk [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the linkblk table. 

map [ -w file ] mapname . . . 

Print the map structure of the given mapname. 

mbfree [ -w file ] 

Print free streams message block headers. 

mblock [ -e ] [ -w filename ] [ [ -p ] table_entry . . . ] 
Print allocated streams message block headers. 

mode [ -w file ] [ mode ] 

Set address translation of arguments to virtual (v) or phy- 
sical (p) mode. If no mode argument is given, the current 
mode is printed. At the start of a crash session, the 
mode is virtual. 
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mount [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Alias: m. 
Print the mount table, 

f nm [ -w file ] symbol . . . 

Print value and type for the given symbol. 

od [ -p ] [ -w file ] [ -format ] [ -mode ] [ -s process ] 
start_addr [ count ] 
Alias: rd. 

Print counf values starting at the start address in one of 
the following formats: character (-c), decimal (-d), hexa- 
decimal (-x), octal (-o), ASCII (-a), or 
hexadecimal/character (-h), and one of the following 
modes: long (-1), short (-t), or byte (-b). The default 
mode for character and ASCII formats is byte; the default 
mode for decimal, hexadecimal, and octal formats is long. 
The format -h prints both hexadecimal and character 
representations of the addresses dumped; no mode 
needs to be specified. When format or mode is omitted, 
the previous value is used. At the start of a crash ses- 

/ ' •, sion, the format is hexadecimal and the mode is long. If 

\~s no count is entered, 1 is assumed. 

pcb [ -w file ] [ process ] 

Print the process control block (TSS) for the given pro- 
cess. If no arguments are given, the active TSS for the 
current process is printed. 

pdt [ -e ] [ -w file ] [ -s process ] section segment 

or 

pdt [ -e ] [ -w file ] [ -s process ] [ -p ] start_addr [ count ] 
The page descriptor table of the designated memory sec- 
tion and segment is printed. Alternatively, the page 
descriptor table starting at the start address for count 
entries is printed. If no count is entered, 1 is assumed. 

pfdat [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the pfdata table. 

i % J proc [ -f ] [ -w file ] [ [ -p ] table_entry . . . #procid . . . ] 

or 

proc [ -f ] [ -w file ] [ -r ] 
Alias: p. 
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Print the process table. Process table information may be 
specified in two ways. First, any mixture of table entries 
and process IDs may be entered. Each process ID must 
be preceded by a #. Alternatively, process table informa- 
tion for runnable processes may be specified with the 
runnable option (-r). 

qrun [ -w file ] 

Print the list of scheduled streams queues. 

queue [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print streams queues. 

quit 

Alias: q. 

Terminate the crash session. 

rcvd [ -e ] [ -f ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the receive descriptor table. 

redirect [ -w file ] [ -c ] 

or 

redirect [ -w file ] [ file ] 

Used with a file name, redirects output of a crash session 
to the named file. If no argument is given, the file name 
to which output is being redirected is printed. Alterna- 
tively, the close option (-c) closes the previously set file 
and redirects output to the standard output. 

region [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the region table. 

sdt [ -e ] [ -w file ] [ -s process ] section 

or 

sdt [ -e ] [ -w file ] [ -s process ] [ -p ] start_addr [ count ] 
The segment descriptor table for the named memory sec- 
tion is printed. Alternatively, the segment descriptor table 
starting at start address for count entries is printed. If no 
count is given, a count of 1 is assumed. 

search [ -p ] [ -w file ] [ -m mask ] [ -s process ] pattern 

start_addr length 

Print the words in memory that match pattern, beginning 
at the start address for length words. The mask is anded 
(&) with each memory word and the result compared 
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against the pattern. The mask defaults to Oxffffffff. 

size [ -w file ] [ -x ] [ structure_name . . . ] 

Print the size of the designated structure. The (-x) option 
prints the size in hexadecimal. If no argument is given, a 
list of the structure names for which sizes are available is 
printed. 



sndd [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the send descriptor table. 

srmount [ -e ] [ -w file ] [ [ -p ] table_entry . . . ] 
Print the server mount table. 

stack [ -w file ] [ process ] 
Alias: s. 

Dump stack. If no arguments are entered, the kernel 
stack for the current process is printed. Otherwise, the 
kernel stack for the given process is printed. 

stat [ -w file ] 

Print system statistics. 

^v stream [ -e ] [ -f ] [ -w file ] [ [ -p ] table_entry . . . ] 

\_J Print the streams table. 

strstat [ -w file ] 

Print streams statistics. 

trace [ -w file ] [ -r ] [ process ] 
Alias: t. 

Print kernel stack trace. The kfp value is used with the -r 
option. 

ts [ -w file ] virtual_address . . . 

Print closest text symbol to the designated address. 

tty [ -e ] [ -f ] [ -w file ] [ -t type [ [ -p ] table_entry . . . ] ] 

or 

tty [ -e ] [ -f ] [ -w file ] [ [ -p ] start_addr ] 
Valid types: pp, iu. 
_ Print the tty table. If no arguments are given, the tty table 

( ) for both tty types is printed. If the -t option is used, the 

"***"* table for the single tty type specified is printed. If no 

argument follows the type option, all entries in the table 
are printed. A single tty entry may be specified from the 
start address. 
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user [ -f ] [ -w file ] [ process ] 
Alias: u. 
Print the ublock for the designated process. 

var [ -w file ] 
Alias: v. 
Print the tunable system parameters. 

vtop [ -w file ] [ -s process ] start_addr . . . 

Print the physical address translation of the virtual start 
address. 

FILES 

/dev/mem system image of currently running system 

SEE ALSO 

diskutil(IM). 
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NAME 

cron - clock daemon 

SYNOPSIS 
/etc/cron 

DESCRIPTION 

Cron executes commands at specified dates and times. Regu- 
larly scheduled commands can be specified according to 
instructions found in crontab files in the directory 
/usr/spool/cron/crontabs. Users can submit their own cron- 
tab file via the crontab (~\) command. Commands which are to 
be executed only once may be submitted via the af(1) com- 
mand. 

Cron only examines cronfab files and af command files during 
process initialization and when a file changes via crontab or at. 
This reduces the overhead of checking for new or changed 
files at regularly scheduled intervals. 

Since cron never exits, it should be executed only once. This 
is done routinely through /etc/rc2.d/S75cron at system boot 
time. The file /usr/lib/cron/FIFO is used as a lock file to 
prevent the execution of more than one cron. 

FILES 

/usr/lib/cron main cron directory 

/usr/lib/cron/FIFO used as a lock file 

/usr/lib/cron/log accounting information 

/usr/spool/cron spool area 

SEE ALSO 

at(1), crontab(1), sh(1) in the User's Reference Manual. 

DIAGNOSTICS 

A history of all actions taken by cron are recorded in 
/usr/lib/cron/log. 
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NAME 

ctinstall, getgrps - install software 

SYNOPSIS 

/install/ctinstall [ update | silent j install ] [ groups ... ] 

DESCRIPTION 

Ctinstall is used to install operating system software and appli- 
cation software from quarter-inch tape and diskette media. It 
must be invoked in single-user mode. 

Before executing ctinstall, the user should cd to the directory 
under which files will be installed. (Normally this is /.) The 
user must ensure that all necessary mounted file systems are 
mounted. 

If no arguments are provided to ctinstall, the user will be 
prompted for the required information. The option install is 
for raw, or first installs; update is for software updates; silent 
is the same as update but with fewer questions asked (silent is 
recommended); groups is any number of group names speci- 
fied in the software product's associated proto file. 

EXAMPLE 

A sample installation session is illustrated here. User 
responses are shown in bold type. A carriage return is 
implied after all user input. 

cd / 
shutdown - i s 

Shutdown started. XXX XXX XX XX:XX:XX XST 19XX 

Broadcast Message from root (console) on 
Convgt XXX XXX XX XX:XX:XX XST 19XX 
THE SYSTEM IS BEING SHUT DOWN NOW I! I 
Log off now or risk your files being damaged. 

Do you really want to shutdown the system? (y or n): y 

Cleaning up, please wait 

System Services are now being stopped 

No demon active 

Error logging stopped 

Line printer scheduler stopped 

LP spooler stopped 

cron aborted: SIGTERM 
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INIT: New run level: S 

INIT: SINGLE USER MODE 

Positioning the tape for Product Installation 

Update, silent update or new installation of ISAM 5.00 
('update', 'silent' or 'install')?: install 

Please enter your group choices for ISAM separated by blanks. 
Your choices are: 

ISAM 

If you'd like all of the groups, type 'all': 

if you'd like none of the groups, type 'none': ISAM 

This procedure will install the following ISAM 5.00 group(s) 
on your system into /: 

ISAM 

Starting to Install Group(s) ISAM into /. 
Installing Group ISAM. 

Calculating size required for group ISAM. 

Installing required ISAM files. 

install/lsamRel 

usr/ i nc 1 ude/ i sam . h 

usr/ i nc 1 ude/ i ser c . h 

usr/1 i b/ i sam/ 1 samConf i g 

usr/1 ib/isam/IsamCreate 

usr/1 i b/ i sam/ I samProtect 

usr/1 ib/isam/IsamReorg 

usr/1 ib/isam/IsamStat 

usr/1 ib/isam/IsamStop 

usr/1 i b/1 sam/ 1 samTr ansf er 

usr/1 i b/ i sam/ 1 xF i 1 tor 

usr/1 ib/isam/lxSpec 

usr/1 ib/isam/isam 

Checking permissions, modes and omissions on new ISAM 

commands . 

Completed Installation of Group ISAM. 

Rewinding tape. 

Installation Complete. 
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SEE ALSO 

Release Notice for software product being installed. 



O 
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NAME 

dcopy - copy file systems for optimal access time 

SYNOPSIS 

/etc/dcopy [ -sX ] [ -an ] [ -d ] [ -v ] [ -ffsize [ : isize ] 

] 

inputfs outputfs 

DESCRIPTION 

Dcopy copies file system inputfs to outputfs. Inputfs is the 
device file for the existing file system; outputfs is the appropri- 
ately sized device file to hold the reorganized result. For the 
most effective optimization inputfs should be the raw device 
and outputfs should be the block device. Both inputfs and 
outputfs should be unmounted file systems (in the case of the 
root file system, the copy must be to a new pack). 

With no options, dcopy copies files from inputfs compressing 
directories by removing vacant entries, and spacing consecu- 
tive blocks in a file by the optimal rotational gap. The possible 
options are 

-sX supply device information for creating an optimal 

organization of blocks in a file. The forms of X 
are the same as the -s option of fsck^M). 

•an place the files not accessed in n days after the 

free blocks of the destination file system (default 
for n is 7). If no n is specified then no movement 
occurs., 

-d leave order of directory entries as is (default is to 

move sub-directories to the beginning of direc- 
tories). 

-v currently reports how many files were processed, 

and how big the source and destination freelists 
are. 

•ffsize [:isize] 

specify the outputfs file system and i-node list 
sizes (in blocks). If the option (or -.isize) is not 
given, the values from the inputfs are used. 

Dcopy catches interrupts and quits, and reports on its pro- 
gress. To terminate dcopy send a quit signal, followed by an 
interrupt or quit. 
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SEE ALSO 

fsck(1M), mkfs(lM). 

ps(1) in the User's Reference Manual. 
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NAME 

dd - convert and copy a file 

SYNOPSIS 

dd [ option = value ] ... 

DESCRIPTION 

Dd copies the specified input file to the specified output with 
possible conversions. The standard input and output are used 
by default. The input and output block size may be specified 
to take advantage of raw physical I/O. 

option values 

it = file input file name; standard input is default 

ot-file output file name; standard output is default 

ibs = n input block size n bytes (default 512) 

obs = n output block size (default 51 2) 

bs = n set both input and output block size, 

superseding ibs and obs; also, if no conver- 
sion is specified, it is particularly efficient since 
no in-core copy need be done 

cbs=n conversion buffer size 

sk!p=n skip n input blocks before starting copy 

seek=n seek n blocks from beginning of output file 

before copying 

count =n copy only n input blocks 

conv = ascii convert EBCDIC to ASCII 
ebcdic convert ASCII to EBCDIC 
ibm slightly different map of ASCII to EBCDIC 
lease map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 
noerror do not stop processing on an error 
sync pad every input block to ibs 
....... several comma-separated conversions 
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Where sizes are specified, a number of bytes is expected. A 
number may end with k, b, or w to specify multiplication by 
1024, 512, or 2, respectively; a pair of numbers may be 
separated by x to indicate multiplication. 

Cbs is used only if conv=ascii or conv = ebcdic is specified. 
In the former case, cbs characters are placed into the conver- 
sion buffer (converted to ASCII). Trailing blanks are trimmed 
and a new-line added before sending the line to the output. 
In the latter case, ASCII characters are read into the conver- 
sion buffer (converted to EBCDIC). Blanks are added to make 
up an output block of size cbs. 

After completion, dd reports the number of whole and partial 
input and output blocks. 

DIAGNOSTICS 

f+p blocks in(out) 

numbers of full and partial blocks read(written) 
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NAME 

devnm - device name 

SYNOPSIS 

/etc/devnm [ names ] 

DESCRIPTION 

Devnm identifies the special file associated with the mounted 
file system where the argument name resides. 

This command is most commonly used by /etc/brc [see 
6rc(1M)] to construct a mount table entry for the root device. 

EXAMPLE 

The command: 

/etc/devnm /usr 
produces: 

/dev/dsk/c0d0s3 usr 
if /usr is mounted on /dev/dsk/c0d0s3. 

FILES 

/dev/dsk/* 
/etc/mnttab 

SEE ALSO 

brc(1M). 
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NAME 

df - report number of free disk blocks and i-nodes 

SYNOPSIS 

df [ -It ] [ -f ] [ file-system j directory j 
mounted-resource ] 

DESCRIPTION 

The df command prints out the number of free blocks and 
free i-nodes in mounted file systems, directories, or mounted 
resources by examining the counts kept in the super-blocks. 

File-system may be specified either by device name (for exam- 
ple, /dev/dsk/c0d0s1) or by mount point directory name (for 
example, /usr). 

Directory can be a directory name. The report presents infor- 
mation for the device that contains the directory. 

Mounted-resource can be a remote resource name. The report 
presents information for the remote device that contains the 
resource. 

If no arguments are used, the free space on all locally and 
remotely mounted file systems is printed. 

The df command uses the following options: 

-I only reports on local file systems. 

-t causes the figures for total allocated blocks and i-nodes 
to be reported as well as the free blocks and i-nodes. 

-f an actual count of the blocks in the free list is made, 
rather than taking the figure from the super-block (free i- 
nodes are not reported). This option will not print any 
information about mounted remote resources. 

NOTE 

If multiple remote resources are listed that reside on the same 
file system on a remote machine, each listing after the first 
one will be marked with an asterisk. 



FILES 

O /dev/dsk/* 

/etc/mnttab 

SEE ALSO 

mount(1M). 
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fs(4), mnttab(4) in the Programmer's Reference Manual. 
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NAME 

diskusg - generate disk accounting data by user ID 

SYNOPSIS 

) /usr/lib/acct/diskusg [ options ] [ files ] 

DESCRIPTION 

Diskusg generates intermediate disk accounting information 
from data in files, or the standard input if omitted. Diskusg 
outputs lines on the standard output, one per user, in the fol- 
lowing format: 

uid login #blocks 

where 

uid is the numerical user ID of the user; 

login is the login name of the user; and 

#blocks is the total number of 512-byte disk blocks allo- 
cated to this user. 

Diskusg normally reads only the i-nodes of file systems for 
\ disk accounting. In this case, files are the special filenames of 

'* these devices. 

Diskusg recognizes the following options: 

-s The input data is already in diskusg output for- 

mat. Diskusg combines all lines for a single user 
into a single line. 

-v Verbose. Print a list on standard error of all files 

that are charged to no one. 

-i fnmlist Ignore the data on those file systems whose file 
system name is in fnmlist. Fnmlist is a list of file 
system names separated by commas or enclose 
within quotes. Diskusg compares each name in 
this list with the file system name stored in the 
volume ID [see labelit(lM)]. 

-p file Use file as the name of the password file to gen- 

) erate login names, /etc/passwd is used by 

default. 

-u file Write records to file of files that are charged to 

no one. Records consist of the special file name, 
the i-node number, and the user ID. 
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The output of diskusg is normally the input to acctdisk [see 
accf(lM)] which generates total accounting records that can 
be merged with other accounting records. Diskusg is nor- 
mally run in dodisk [see acctsh (1M)]. 

EXAMPLES 

The following will generate daily disk accounting information: 

for i in s1 S3; do 

diskusg /dev/rdsk/cOdO$i > dtmp.'basename $i' & 
done 
wait 
diskusg -s dtmp.* I sort +0n +1 | acctdisk > disktacct 

FILES 

/etc/passwd used for user ID to login name conver- 

sions 

SEE ALSO 

acct(1M), acctsh(1M). 

acct(4) in the Programmer's Reference Manual. 
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NAME 

diskutil - display disk information, copy in crash dump files 

SYNOPSIS 

diskutil -cdlbpvBsk devicefile 

diskutil -D devicefile crashdumpfile 

DESCRIPTION 

The first form of the diskutil command displays configuration 
information for the disk drive specified by devicefile. 

The second form of the command copies a crash dump file 
from the specified devicefile into crashdumpfile, where it can 
be accessed and analyzed using crash (1M). 

Diskutil understands the following options. Devicefile must 
specify a device that has a valid volume home block (VHB): 

-c Print the disk parameters for devicefile. 

-d Print the starting location and size of the dump area for 
the specified disk device. 

-I Print the starting location and size of the loader area for 
the specified disk device. 

-b Print the starting location and size of the boot area for the 
specified disk device. 

-p Print the partition table for the specified disk device. 

-v Verbose mode: used with -dlb, prints out additional 
descriptive detail along with the statistics. 

-B Display information requested by the -dlb options as 
number of bytes. 

-s Display information requested by the -dlb options as 
number of sectors. 

-k Display information requested by the -dlb options as 
number of 1K blocks. 

EXAMPLES 

To display loader area information for device 
/dev/rdsk/cOdOsO: 

$ diskutil -1 /dev/rdsk/cOdOsO 

1 128 

$ 
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To print the same information in verbose mode using byte 
units: 

$ diskutil -lvB /dev/rdsk/cOdOsO 

Loader area : start at byte offset 1021, 
size ( 131072 bytes ). 
$ 

To display the disk parameters for the same device: 

$ diskutil -c /dev/rdsk/cOdOsO 

Volume: 0280 
876 cyl inders, 
6 heads, 

32 physical sectors (of 512 bytes) per track, 
182 physical sectors per cylinder, 
168182 physical sectors per disk 
$ 
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NAME 

dname 
names 



print Remote File Sharing domain and network 



SYNOPSIS 

dname [ -D domain ] [ -N netspec ] [ -dna ] 

DESCRIPTION 

Dname prints or defines a host's Remote File Sharing domain 
name or the network used by Remote File Sharing as tran- 
sport provider. When used with d, n, or a options, dname can 
be run by any user to print the domain name, network name 
or both, respectively. Only a user with root permission can 
use the -D domain option to set the domain name for the host 
or -N netspec to set the network specification used for 
Remote File Sharing. (The value of netspec is the network 
device name, relative to the /dev directory. For example, the 
TCP network uses tap.) 

Domain must consist of no more than 14 characters, consist- 
ing of any combination of letters (upper and lower case), 
digits, hyphens (-), and underscores (_). 

When dname is used to change a domain name, the host's 
password is removed. The administrator will be prompted for 
a new password the next time Remote File Sharing is started 
[rfstart (1M)]. 

If dname is used with no options, it will default to dname -d. 

ERRORS 

You cannot use the -N or -D options while Remote File Shar- 
ing is running. 

SEE ALSO 

rfstart(lM). 
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NAME 

drvload - load drivers 

SYNOPSIS 
f~""\ drvload [ -n ] [ -d ] [ driver ] 

DESCRIPTION 

This program is executed at boot time to load all loadable 
drivers. If drvload is executed with no arguments, it loads all 
drivers listed in the file /etc/lddrv/drvtab. If a driver argument 
is given, that driver is loaded and is also installed in 
/etc/lddrv/drvtab, so that it will be automatically loaded every 
time the system is booted. 

Drvload has two options: 

-n Causes the driver to be installed in /etc/lddrv/drvtab 
without being loading. [To load a driver without installing 
it in /etc/lddrv/drvtab, see lddrv(1M)]. 

-d This flag with no arguments causes all drivers listed in 
/etc/lddrv/drvtab to be unloaded. Supplying a driver 
argument causes that driver only to be unloaded and 
f '"") removed from /etc/lddrv/drvtab. 

The -d flag with the -n flag and a driver argument causes the 
driver to be removed from /etc/lddrv/drvtab without unload- 
ing it. In all cases, if the driver load or unload fails, 
/etc/lddrv/drvtab is not updated. 

FILES 

/etc/lddrv/drvtab 

SEE ALSO 

lddrv(1M). 



i 
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NAME 

du - summarize disk usage 

SYNOPSIS 

du [ -sar ] [ names ] 

DESCRIPTION 

Du reports the number of 512-byte blocks contained in all files 
and (recursively) directories within each directory and file 
specified by the names argument. The block count includes 
the indirect blocks of the file. If names is missing, the current 
directory is used. 

The optional arguments are as follows: 

-s causes only the grand total (for each of the specified 
names) to be given. 

•a causes an output line to be generated for each file. 

If neither -s or -a is specified, an output line is generated for 
each directory only 

-r will cause du to generate messages about directories that 
cannot be read, files that cannot be opened, and so forth, 
rather than being silent (the default). 

A file with two or more links is only counted once. 

BUGS 

If the -a option is not used, non-directories given as argu- 
ments are not listed. 

If there are links between files in different directories where 
the directories are on separate branches of the file system 
hierarchy, du will count the excess files more than once. 
Files with holes in them will get an incorrect block count. 
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NAME 

errdead - extract error records and status information from 
dump 

SYNOPSIS 

/etc/errdead [ -a [ e ] ] [ -v ] [ -d offset] [ dumpfile ] [ 
namelist ] 

DESCRIPTION 

When hardware errors are detected by the system, an error 
record that contains information pertinent to the error is gen- 
erated. If the error-logging daemon errdemon (1M) is not 
active, or if the system crashes before the record can be 
placed in the error file, the error information is held by the 
system in a local buffer. By default, errdead examines a sys- 
tem dump (or memory), extracts such error records, and 
passes them to errpt (1M) for analysis. 

Errdead understands the following options: 

-a Instead of passing extracted records to errpt (MA), append 
them to /usr/adm/errfile, provided that the dump 
f""\ corresponds to the namelist. 

-e Only valid if -a is also specified. Invoke errdemon (1M) 
when done. This is normally done in the re script. 

-v Indicates that the dump file is a "virtual" dump: a virtual 
address can be used directly without translation into a 
physical address. The -v option should be used only with 
/dev/kmem, not with ordinary dump files. 

-d offset Indicates that the dump file has a header of size 
offset bytes. The actual memory image starts at byte 
offset in the dump file. 

The dumpfile specifies the file (or memory) that is to be exam- 
ined; if not given, errdead looks for a dump area by scanning 
the available disks in the same order as does the bootstrap 
ROM. The system namelist is specified by namelist; if not 
given, /unix is used. 

FILES 

/unix system namelist 

/usr/bin/errpt analysis program 

/usr/tmp/errXXXXXX temporary file 

/usr/adm/errfile repository for error records 
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/etc/log/confile console file 

DIAGNOSTICS 

Diagnostics may come from either errdead or errpt. In either 
case, they are intended to be self-explanatory. 

SEE ALSO 

errdemon(lM), errpt(1M). 
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NAME 

errdemon - error-logging daemon 

SYNOPSIS 

/usr/lib/errdemon [ -n ] [ -c file ] [ file ) 

DESCRIPTION 

The error logging daemon errdemon collects error records 
from the operating system by reading the special file 
/dev/error and places them in file. If file is not specified 
when the daemon is activated, /usr/adm/errfile is used. Note 
that file is created if it does not exist; otherwise, error records 
are appended to it, so that no previous error data is lost. No 
analysts of the error records is done by errdemon; that 
responsibility is left to e/rpf(1M). Errdemon can also extract 
console records; the -n option disables this, thus forcing all 
console reports to stay in a circular buffer in the kernel. The 
-c option allows specifying a console file. The default console 
file is /etc/log/confile. The error-logging demon is terminated 
by sending it a software kill signal [see Jw7/(1)]. Only the 
super-user may start the daemon, and only one daemon may 
be active at any time. 

FILES 

/dev/error source of error records 

/usr/adm/errfile repository for error records 
/etc/log/confile console records 
/dev/console 

DIAGNOSTICS 

The diagnostics produced by errdemon are intended to be 



self-explanatory. 

SEE ALSO 

errpt(1M), errstop(lM), err(7). 

kill(1) in the User's Reference Manual. 
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NAME 

errpt - process a report of logged errors 

SYNOPSIS 
{^ '< errpt [ options ] [ files ] 

DESCRIPTION 

Errpt processes data collected by the error logging mechan- 
ism [errdemon(1M)] and generates a report of that data. The 
default report is a summary of all errors posted in the files 
named. Options apply to all files and are described below. If 
no files are specified, errpt attempts to use /usr/adm/errfile 
as file. 

A summary report notes the options that may limit its com- 
pleteness, records the time stamped on the earliest and latest 
errors encountered, and gives the total number of errors of 
one or more types. Each device summary contains the total 
number of unrecovered errors, recovered errors, errors 
unabled to be logged, I/O operations on the device, and mis- 
cellaneous activities that occurred on the device. The number 
of times that errpt has difficulty reading input data is included 
as read errors. 

Any detailed report contains, in addition to specific error infor- 
mation, all instances of the error logging process being 
started and stopped, and any time changes [via dafe(1)] that 
took place during the interval being processed. A summary of 
each error type included in the report is appended to a 
detailed report. 

A report may be limited to certain records in the following 
ways; 

-s date Ignore all records posted earlier than date, where 

dare has the form mmddhhmmyy , consistent in 
meaning with the dafe(1) command. 

-e date Ignore all records posted later than date, whose 
form is as described above. 

-a Produce a detailed report that includes all error 

types. 

-d devlist A detailed report is limited to data about devices 
given in devlist, where devlist can be one of two 
forms: a list of device identifiers separated from 

UP-13529 Page 1 



V»,/ 



O 



ERRPT(IM) 



one another by a comma, or a list of device iden- 
tifiers enclosed in double quotes and separated 
from one another by a comma and/or more 
spaces. Valid devices are the character and 
block devices that appear in /etc/master. 

-p n Limit the size of a detailed report to n pages. 

-f In a detailed report, limit the reporting of block 

device errors to unrecovered errors. 

Logical blocks in the filesystem are 1024 bytes. Physical sec- 
tor numbers are 512-byte blocks. 

FILES 

/usr/adm/errfile default error file 

SEE ALSO 

errdead(IM), errdemon(IM). 

date(1) in the User's Reference Manual. 

errfile(4) in the Programmer's Reference Manual. 



( \ 



Page 2 UP-13529 



ERRSTOP(IM) 



v_.< 



^SsSSs*^ 






NAME 

errstop - terminate the error-logging daemon 

SYNOPSIS 

/etc/errstop [ namelist ] 

DESCRIPTION 

The error-logging daemon errdemon^M) is terminated by 
using errstop. This is accomplished by executing ps(1) to 
determine the daemon's identity and then sending it a 
software kill signal [see signal (2)]; /unix is used as the system 
namelist if none is specified. Only the super-user may use 
errstop. 

FILES 

/unix default system namelist 

DIAGNOSTICS 

The diagnostics produced by errstop are intended to be self- 
explanatory. 

SEE ALSO 

errdemon(IM). 

ps(1) in the User's Reference Manual. 

kill(2), signal(2) in the Programmer's Reference Manual. 
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NAME 

ff - list file names and statistics for a file system 

SYNOPSIS 

/etc/ff [ options ] special 

DESCRIPTION 

Ff reads the i-list and directories of the special file, assuming 
it is a file system. I-node data is saved for files which match 
the selection criteria. Output consists of the path name for 
each saved i-node, plus other file information requested using 
the print options below. Output fields are positional. The out- 
put is produced in i-node order; fields are separated by tabs. 
The default line produced by ff is: 

path-name i-number 

With all options enabled, output fields would be: 

path-name i-number size uid 

The argument n in the option descriptions that follow is used 
as a decimal integer (optionally signed), where +n means 
more than n, -n means less than n, and n means exactly n. A 
day is defined as a 24 hour period. 

-I Do not print the i-node number after each path 

name. 

-I Generate a supplementary list of all path names 

for multiply-linked files. 

-p prefix The specified prefix will be added to each gen- 
erated path name. The default is . (dot). 

-s Print the file size, in bytes, after each path 

name. 

-u Print the owner's login name after each path 

name. 

-an Select if the i-node has been accessed in n 

days. 

-m n Select if the i-node has been modified in n days. 

-c n Select if the i-node has been changed in n days. 

-n file Select if the i-node has been modified more 

recently than the argument file. 
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-i i-node-list Generate names for only those i-nodes specified 
in i-node-list. 

EXAMPLES 

To generate a list of the names of all files on a specified file 
system: 

f f - 1 /dev/rdsk/c0d0s1 

To produce an index of files and i-numbers which are on a file 
system and have been modified in the last 24 hours: 

ff -m -1 /dev/c0d0s1 > /log/fncbackup/usr/tuesday 

To obtain the path names for i-nodes 451 and 76 on a speci- 
fied file system: 

ff -i 451,76 /dev/rdsk/c0d1s3 

SEE ALSO 

frec(1M), ncheck(1M). 

find(1) in the User's Reference Manual, 

BUGS 

If the -I option is not specified, only a single path name out of 
all possible ones is generated for a multiply-linked i-node. If -I 
is specified, all possible names for every linked file on the file 
system are included in the output. However, no selection cri- 
teria apply to the names generated. 

On very large file systems, memory may run out before ff 
does. 
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NAME 

free - recover files from a backup tape 

SYNOPSIS 

f ) /etc/free [ -p path ] [ -f reqfile ] rawjape i_number : 

v — "' name ... 

DESCRIPTION 

Free recovers files from the specified rawjape backup tape 
written by vo/copy(1M), given their ijiumbers. The data for 
each recovery request will be written into the file given by 
name. 

The -p option allows you to specify a default prefixing path 
different from your current working directory. This will be pre- 
fixed to any names that are not fully qualified, that is to say, 
that do not begin with / or ./. If any directories are missing in 
the paths of recovery names they will be created. 

•p path Specifies a prefixing path to be used to fully qual- 

ify any names that do not start with / or ./. 

-f reqfile Specifies a file which contains recovery requests. 
f^*\ The format is ijiumber: newname, one per line. 

"^ EXAMPLES 

To recover a file, i-number 1216 when backed-up, into a file 
named junk in your current working directory: 

free /dev/rmtO 1216: junk 

To recover files with ijiumbers 14156, 1232, and 3141 into 
files /usr/sre/emd/a, /usr/sre/emd/b, and /usr/Joe/a.c: 

free -p /usr/src/cmd /dev/rmtO 1*»156:a 1232 :b 
3141 :/usr /joe/a. c 

SEE ALSO 

ff(1M), labelit(IM), volcopy(IM). 
cpio(1) in the User's Reference Manual. 
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BUGS 

While paving a path (that is to say, creating the intermediate 
directories contained in a pathname) free can only recover i- 
node fields for those directories contained on the tape and 
requested for recovery. 
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NAME 

fsck, dfsck, checkall - check and repair file systems 

s~^ SYNOPSIS 

{ 1 /etc/fsck [ -y ] [ -n ] [ -sc:s ] -s ] [ -Sc:s ] -S ] 

[ -t file ] 

I -q ] [ -D ] [ -f ] [ -p ] [ -bB ] [ -O ) [ -M ] 

[ file-systems ] 

/etc/dfsck [ options 1 ] fsysl ... - f options2 ] fsys2 ... 

checkall [ -amtvx ] [ -F flags ] [ fstab ] 

DESCRIPTION 
Fsck 

Fsck audits and interactively repairs inconsistent conditions for 
file systems. If the file system is found to be consistent, the 
number of files, number of blocks used, and number of blocks 
free are reported. If the file system is inconsistent, the user is 
prompted for concurrence before each correction is 
attempted. It should be noted that some corrective actions 
will result in some loss of data. The amount and severity of 
f" "\ data loss may be determined from the diagnostic output. The 

^~~ J default action for each correction is to wait for the user to 

respond yes or no. Upon completion fsck reports the number 
of used and free 1024-byte blocks and the number of files in 
the file system. 

Modifying a mounted (root) file system requires special pre- 
cautions by fsck, because a single sync (2) will undo all of 
fsck's repair work. To prevent this, fsck performs a syslo- 
ca/(2) RESYNC. The system call forces the operating system 
to reread the superblock from the disk. 

Fsck has more consistency checks that its predecessors 
check, dcheck, fcheck, and icheck combined. 

The following options are accepted by fsck. 

-y Assume a yes response to all questions asked by fsck. 

s~^ -n Assume a no response to all questions asked by fsck; do 

( ) not open the file system for writing. 

-sc:s 

Ignore the actual free list or bit map and (unconditionally) 
reconstruct a new one by rewriting the super-block of the 
file system. The file system should be unmounted while 
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this is done; if this is not possible, care should be taken 
that the system is quiescent and that it is rebooted 
immediately afterwards. This precaution is necessary so 
that the old, bad, in-core copy of the superblock will not 
continue to be used, or be written on the file system. 

The -sets option allows for creating an optimal free-list 
organization. If c:s is given on a standard file system, the 
free list is organized with c blocks per cylinder and s 
blocks skipped. If c:s is not given, the values used when 
the file system was created are used. 

-Sc:s 

Conditionally reconstruct the free list. This option is like 
-sc:s above except that the free list or bit map is rebuilt 
only if there were no discrepancies discovered in the file 
system. Using -S will force a no response to all questions 
asked by fsck. This option is useful for forcing free list 
reorganization on uncontaminated file systems. 

-t If fsck cannot obtain enough memory to keep its tables, it 
uses a scratch file. If the -t option is specified, the file 
named in the next argument is used as the scratch file, if 
needed. Without the -t flag, fsck will prompt the user for 
the name of the scratch file, if needed. The file chosen 
should not be on the file system being checked, and if it 
is not a special file or did not already exist, it is removed 
when fsck completes. 

-q Quiet fsck. Do not print size-check messages. Unrefer- 
enced fifos will silently be removed. If fsck requires it, 
counts in the superblock will automatically be fixed and 
the free list or bit map salvaged. 

-D Directories are checked for consistency. Useful after sys- 
tem crashes. The following inconsistencies are sought: 

• Entries with null names but nonzero i-numbers. 

• Entries that are not padded to full size with nulls. 

• Invalid . and . . entries. 

• Names that contain. "/". 

• Final blocks that ar.e not cleared past end-of-file. 
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-f Fast check. Check block and sizes (Phase 1) and check 
the free list or bit map (Phase 5). The free list or bit map 
will be reconstructed (Phase 6) if necessary. 

f~^\ -p Preen file systems only; intended for auto boot. No 

S <~J operator input is prompted for. Instead, fsck applies stan- 

dard fixes whenever the fix doesn't involve loss of data. 
Only the following problems are subject to this kind of fix: 

• Unreferenced i-nodes. 

• Link counts in i-nodes too large. 

• Missing blocks in the free list. 

• Blocks in the free list also in files. 

• Counts in the superblock wrong. 

Any problem not of this type causes fsck to terminate 
with an error status. The startup script that runs fsck 
(normally /etc/bcheckrc) can specify the -p option to fsck 
and make a normal boot contingent upon a normal fsck 
return status. 

-b or -B 

^r-. If the file system was mounted, resync the file system 

\^J after modifying it. This will cause the in-core superblock 

and i-nodes to be updated from the disk. This option 

should nearly always be used. 

-M Convert file system to new bit map free list format. 

-O Convert file system to old free list format. 

Both -M and -O imply -s (reconstruct free list and superblock). 

If no f7/e-sysfems are specified, fsck will read a list of default 
file systems from the file /etc/checklist. Note that this default 
check is provided for compatibility, and should not be used as 
the standard means of checking file systems. The list of file 
systems should be maintained in /etc/fstab, and checkall 
(rather than fsck) should be used to check all file systems. 

Inconsistencies checked are as follows: 

1. Blocks claimed by more than one i-node or the free list. 

2. Blocks claimed by an i-node or the free list outside the 
range of the file system. 

3. Incorrect link counts. 
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4. Size checks: 

• Incorrect number of blocks. 

• Directory size not 16-byte aligned. 

5. Bad i-node format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

• File pointing to unallocated i-node. 

• I-node number out of range. 

8. Super Block checks: 

• More than 65536 i-nodes. 

• More blocks for i-nodes than there are in the file sys- 
tem. 

9. Bad free block list format. 

10. Total free block and/or free i-node count incorrect. 

Orphaned files and directories (allocated but unreferenced) 
are, with the user's concurrence, reconnected by placing them 
in the lost + found directory, if the files are nonempty. The 
user will be notified if the file or directory is empty or not. 
Empty files or directories are removed, as long as the -n 
option is not specified. Fsck will force the reconnection of 
nonempty directories. The name assigned is the i-node 
number. The only restriction is that the directory lost + found 
must preexist in the root of the file system being checked and 
must have empty slots in which entries can be made. This is 
accomplished either by using mklost+ found (1M), or by mak- 
ing lost + found, then copying a number of files to the direc- 
tory and removing them (before fsck is executed). 

Checking the raw device is almost always faster and should be 
used with everything but the roof file system. 

Dfsck 

This version of the fsck command is appropriate for computer 
systems equipped with more than one hard disk drive. Dfsck 
should not be used to check the roof file system. 

Dfsck allows two file system checks on two different drives 
simultaneously. Optionsl and options2 are used to pass 
options to fsck for the two sets of file systems. A - is the 
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separator between the file system groups. 

The dfsck program permits a user to interact with two fsck 
programs at once. To aid in this, dfsck will print the file sys- 
tem name for each message to the user. When answering a 
question from dfsck, the user must prefix the response with a 
1 or a 2 (indicating that the answer refers to the first or 
second file system group). 

Checkall 

Checkall checks all file systems listed in /etc/fstab, by running 
fsck(lM) on each one. Normally, only unmounted file systems 
are checked. The normal use of this command is to check the 
disks after a boot time fsck failure causes the system to enter 
ADMIN MODE (init state 5). 

Flags for use with checkall are: 

-v Specifies verbose mode; more information is displayed. 

-a Causes mounted file systems to be checked. 

-m Causes checkall to mount each unmounted file system 
after it is checked. 

-x Causes mountall to exit immediately when any fsck fails. 

-F Causes the following flags to be passed to each invoca- 
tion of fsck (instead of the default flags -b -D). 

-t Causes the system to enter ADMIN MODE (init state 5) on 
any fsck failure. This flag is intended for use by the boot 
time scripts and should not be used otherwise. 

If the fstab argument is given, that file is used instead of 
/etc/fstab. 

NOTES 

The -b option should nearly always be used. 

The raw device should always be used with mounted file sys- 
tems. 

FILES 

/etc/checklist contains default list of file systems to 

check. 

/etc/fstab file system list. 
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SEE ALSO 

clri(lM), init(1M), mkfs(1M), mklost+ found (1M), ncheck(1M), 

crash(1M). 

checklist(4), fs(4) in the Programmer's Reference Manual. 

BUGS 

I-node numbers for . and . . in each directory are not checked 
for validity. 
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NAME 

fsdb - file system debugger 

SYNOPSIS 

/etc/fsdb special [ • ] 

DESCRIPTION 

Fsdb can be used to patch up a damaged file system after a 
crash. It has conversions to translate block and i-numbers 
into their corresponding disk addresses. Also included are 
mnemonic offsets to access different parts of an i-node. 
These greatly simplify the process of correcting control block 
entries or descending the file system tree. 

Fsdb contains several error-checking routines to verify i-node 
and block addresses. These can be disabled if necessary by 
invoking fsdb with the optional - argument or by the use of 
the O symbol. (Fsdb reads the i-size and f-size entries from 
the superblock of the file system as the basis for these 
checks.) 

Numbers are considered decimal by default. Octal numbers 
must be prefixed with a zero. During any assignment opera- 
tion, numbers are checked for a possible truncation error due 
to a size mismatch between source and destination. 

Fsdb reads a block at a time and will therefore work with raw 
as well as block I/O. A buffer management routine is used to 
retain commonly used blocks of data in order to reduce the 
number of read system calls. All assignment operations result 
in an immediate write-through of the corresponding block. 

The symbols recognized by fsdb are: 

# absolute address 

i convert from i-number to i-node address 





b convert to block address 




d directory slot offset 




+ • * / 




address arithmetic 


1. / 


q quit 




> , < save, restore an address 
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= numerical assignment 

= + incremental assignment 

=- decrements assignment 

= " character string assignment 

error checking flip-flop 
p general print facilities 

f file print facility 

F buffer status 

X hexadecimal or octal address flip-flop (default is 

hexadecimal) B byte mode 

W word mode 

D double word mode 

1 escape to shell 

The print facilities generate a formatted output in various 
styles. The current address is normalized to an appropriate 
boundary before printing begins. It advances with the printing 
and is left at the address of the last item printed. The output 
can be terminated at any time by typing the delete character. 
If a number follows the p symbol, that many entries are 
printed. A check is made to detect block boundary overflows 
since logically sequential blocks are generally not physically 
sequential. If a count of zero is used, all entries to the end of 
the current block are printed. 

The print options available are: 

i print as i-nodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 

s or S 

print as superblock 
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x print as hexadecimal words 

h print as hexadecimal bytes 

The f symbol is used to print data blocks associated with the 
current i-node. If followed by a number, that block of the file 
is printed. (Blocks are numbered from zero.) The desired 
print option letter follows the block number, if present, or the f 
symbol. This print facility works for small as well as large files. 
It checks for special devices and that the block pointers used 
to find the data are not zero. 

Dots, tabs, and spaces may be used as function delimiters but 
are not necessary. A line with just a new-line character will 
increment the current address by the size of the data type last 
printed. That is, the address is set to the next byte, word, 
double word, directory entry, or i-node, allowing the user to 
step through a region of a file system. Information is printed 
in a format appropriate to the data type. Bytes, words, and 
double words are displayed with the octal address followed by 
the value in octal and decimal. A .B or .D is appended to the 
address for byte and double word values, respectively. Direc- 
tories are printed as a directory slot offset followed by the 
decimal i-number and the character representation of the 
entry name. I-nodes are printed with labeled fields describing 
each element. 

The following mnemonics are used for i-node examination and 
refer to the current working i-node: 

md mode 

In link count 

uld user ID number 

gid group ID number 

sz file size 

a# data block numbers (0 - 12) 

at access time 

mt modification time 

maj 

major device number 
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mm 

minor device number 

si #i-nodes field in superblock 
sf #blks field in superblock 

sdO 

s_dinfo[0] in superblock 

sd1 

s_dinfo[1] in superblock 

= BS 

set a blank superblock with file system type 1K and a 
magic number. 

EXAMPLES 

386} prints i-number 386 in an i-node format. This 

now becomes the current working i-node. 

in=i changes the link count for the working i-node 

to 4. 

in=+i increments the link count by 1. 

fc prints, in ASCII, block zero of the file associ- 

ated with the working i-node. 

2i.fd prints the first 32 directory entries for the root 

i-node of this file system. 

dsi.fc changes the current i-node to that associated 

with the 5th directory entry (numbered from 
zero) found from the above command. The 
first logical block of the file is then printed in 
ASCII. 

5i2B.poo prints the superblock of this file system in 

octal. 

2i.a0b.d7=3 changes the i-number for the seventh directory 
slot in the root directory to 3. This example 
also shows how several operations can be 
combined on one command line. 

d7.nro="name" changes the name field in the directory slot to 
the given string. Quotes are optional when 
used with nm if the first character is alphabetic. 
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a2b.pod prints the third block of the current i-node as 

directory entries. 

512.ps prints the superblock. 

SEE ALSO 

fsck(1M). 

dir(4), fs(4) in the Programmer's Reference Manual. 
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NAME 

fsstat - report file system status 

SYNOPSIS 

/etc/fsstat specialjile 

W DESCRIPTION 

Fsstat reports on the status of the file system on specialjile. 
During startup, this command is used to determine if the file 
system needs checking before it is mounted. Fsstat succeeds 
if the file system is unmounted and appears to be in good 
condition. For the root file system, it succeeds if the file sys- 
tem is active and not marked bad. 

SEE ALSO 

fs(4) in the Programmer's Reference Manual. 

DIAGNOSTICS 

The command has the following exit codes: 

the file system is not mounted and appears okay, (except 
for root where means mounted and okay). 

1 the file system is not mounted and needs to be checked. 
\_) 2 the file system is mounted. 

3 the command failed. 
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NAME 

fstyp - determine file system identifier 

SYNOPSIS 
fstyp special 

DESCRIPTION 

Fstyp allows the user to determine the file system identifier of 
mounted or unmounted file systems using heuristic programs. 
The file system type is required by mount (1M) to mount file 
systems of different types. 

The directory /etc/fstyp.d contains a program for each file 
system type to be checked; each of these programs applies 
some appropriate heuristic to determine whether the supplied 
special file is of the type for which it checks. If it is, the pro- 
gram prints on standard output the usual file-system identifier 
for that type and exits with a return code of 0; otherwise it 
prints error messages on standard error and exits with a non- 
zero return code. Fstyp runs the programs in /etc/fstyp.d in 
alphabetical order, passing special as an argument; if any pro- 
gram succeeds, its file-system type identifier is printed and 
fstyp exits immediately. If no program succeeds, fstyp prints 
"Unknown_fstyp" to indicate failure. 

WARNING 

The use of heuristics implies that the result of fstyp is not 
guaranteed to be accurate. 

SEE ALSO 

mount(1M). 

mount(2), sysfs(2) in the Programmer's Reference Manual. 
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NAME 

fumount - forced unmount of an advertised resource 

SYNOPSIS 

s~\ fumount [ -w sec ] resource 

x ,.J DESCRIPTION 

Fumount unadvertises resource and disconnects remote 
access to the resource. The -w sec causes a delay of sec 
seconds prior to the execution of the disconnect. 

When the forced unmount occurs, an administrative shell 
script is started on each remote computer that has the 
resource mounted (/usr/bin/rfuadmin). If a grace period of 
seconds is specified, rfuadmin is started with the fuwarn 
option. When the actual forced unmount is ready to occur, 
rfuadmin is started with the fumount option. See rfuadmin (1M) 
for information on the action taken in response to the forced 
unmount. 

* This command is restricted to the super-user. 

" ERRORS 

If resource (1) does not physically reside on the local machine, 
(2) is an invalid resource name, (3) is not currently advertised 
and is not remotely mounted, or (4) the command is not run 
with super-user privileges, an error message will be sent to 
standard error. 

SEE ALSO 

adv(1M), mount(1M), rfuadmin(IM), rfudaemon(IM), 
rmount(lM), unadv(1M). 



V_*/ 
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NAME 

fusage - disk access profiler 

SYNOPSIS 
(~~~) fusage [ [ mount_point ] j [ advertised_resource ] [ 

*"~"* I block_special_device ][...]] 

DESCRIPTION 

When used with no options, fusage reports block I/O 
transfers, in kilobytes, to and from all locally mounted file sys- 
tems and advertised Remote File Sharing resources on a per 
client basis. The count data are cumulative since the time of 
the mount. When used with an option, fusage reports on the 
named file system, advertised resource, or block special dev- 
ice. 



The report includes one section for each file system and 
advertised resource and has one entry for each machine that 
has the directory remotely mounted, ordered by decreasing 
usage. Sections are ordered by device name; advertised 
resources that are not complete file systems will immediately 
follow the sections for the file systems they are in. 

SEE ALSO 

adv(1M), mount(1M), df(1M), crash(1M). 
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NAME 

fuser - identify processes using a file or file structure 

SYNOPSIS 

( j /etc/fuser [ -ku ] files | resources [ - ] [ [ -ku ] files | 

"*"" resources ] 

DESCRIPTION 

Fuser outputs the process IDs of the processes that are using 
the files or remote resources specified as arguments. Each 
process ID is followed by a letter code, interpreted as follows: 
if the process is using the file as (1) its current directory, the 
code is c, (2) the parent of its current directory (only when the 
file is being used by the system), the code is p, or (3) its root 
directory, the code is r. For block special devices with 
mounted file systems, all processes using any file on that dev- 
ice are listed. For remote resource names, all processes using 
any file associated with that remote resource (Remote File 
Sharing) are reported. {Fuser cannot use the mount point of 
the remote resourcs; it must use the resource name.) For all 
other types of files (text files, executables, directories, devices, 
and so forth) only the processes using that file are reported. 

The following options may be used with fuser: 

-u the user login name, in parentheses, also follows the pro- 
cess ID. 



^tea^ 



-k the SIGKILL signal is sent to each process. Since this 
option spawns kills for each process, the kill messages 
may not show up immediately [see kill (2)]. 

If more than one group of files are specified, the options may 
be respecified for each additional group of files. A lone dash 
cancels the options currently in force; then, the new set of 
options applies to the next group of files. 

The process IDs are printed as a single line on the standard 
output, separated by spaces and terminated with a single new 
line. All other output is written on standard error. 

You cannot list processes using a particular file from a remote 
*v_/ resource mounted on your machine. You can only use the 

resource name as an argument. 

Any user with permission to read /dev/kmem and /dev/mem 
can use fuser. Only the super-user can terminate another 
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user's process. 

FILES 

/unix for system namelist 

/dev/kmem for system image 

/dev/mem also for system image 

SEE ALSO 

mount(lM). 

ps(1) in the User's Reference Manual. 

kill(2), signal(2) in the Programmer's Reference Manual. 
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NAME 

gencc - create a front-end to the cc command 



,— x, SYNOPSIS 



gencc 

DESCRIPTION 

The gencc command is an interactive command designed to 
aid in the creation of a front-end to the cc command. Since 
hard-coded pathnames have been eliminated from the C 
Compilation System (CCS), it is possible to move pieces of the 
CCS to new locations without recompiling the CCS. The new 
locations of moved pieces can be specified through the -Y 
option to the cc command. However, it is inconvenient to 
supply the proper -Y options with every invocation of the cc 
command. Further, if a system administrator moves pieces of 
the CCS, such movement should be invisible to users. 

The front- end to the cc command which gencc generates is a 
one-line shell script which calls the cc command with the 
proper -Y options specified. The front-end to the cc com- 
mand will also pass all user-supplied options to the cc com- 
mand. 

Gencc prompts for the location of each tool and directory 
which can be respecified by a -Y option to the cc command. 
If no location is specified, it assumes that that piece of the 
CCS has not beer, relocated. After all the locations have been 
prompted for, gencc will create the front-end to the cc com- 
mand. 

Gencc creates the front-end to the cc command in the current 
working directory and gives the file the same name as the cc 
command. Thus, gencc can not be run in the same directory 
containing the actual cc command. Further, if a system 
administrator has redistributed the CCS, the actual cc com- 
mand should be placed somewhere which is not typically in a 
user's PATH (for example, /lib). This will prevent users from 
accidentally invoking the cc command without using the 
front-end. 

CAVEATS 

Gencc does not produce any warnings if a tool or directory 
does not exist at the specified location. Also, gencc does not 
actually move any files to new locations. 
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FILES 

./cc front- end to cc 

SEE ALSO f 

cc(1). V 
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NAME 

getty - set terminal type, modes, speed, and line discipline 

SYNOPSIS 

( /etc/getty [ -h ] [ -t timeout ] line [ speed [ type 

v [ linedisc ] ] ] 

/etc/getty -c file 

DESCRIPTION 

Getty is a program that is invoked by /n/f(1M). It is the second 
process in the series, (init-getty-login-shell) that ultimately 
connects a user with the 6000/50 system. It can only be exe- 
cuted by the super-user; that is, a process with the user-ID of 
root. Initially getty prints the login message field for the entry 
it is using from /etc/gettydefs. Getty reads the user's login 
name and invokes the /og/n(l) command with the user's name 
as argument. While reading the name, geffy attempts to 
adapt the system to the speed and type of terminal being 
used. It does this by using the options and arguments speci- 
fied. 



o 



Line is the name of a tty line in /dev to which getty is to 
attach itself. Geffy uses this string as the name of a file in the 
/dev directory to open for reading and writing. Unless gerfy is 
invoked with the -h flag, geffy will force a hangup on the line 
by setting the speed to zero before setting the speed to the 
default or specified speed. The -t flag, plus timeout (in 
seconds), specifies that geffy should exit if the open on the 
line succeeds and no one types anything in the specified 
number of seconds. 

Speed, the optional second argument, is a label to a speed 
and tty definition in the file /etc/gettydefs. This definition tells 
getty at what speed to initially run, what the login message 
should look like, what the initial tty settings are, and what 
speed to try next should the user indicate that the speed is 
inappropriate (by typing a <break> character). The default 
speed is 9600 baud. 

f\ Type, the optional third argument, is a character string 

V„ '* describing to geffy what type of terminal is connected to the 

line in question. Geffy recognizes the following types: 
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none 


default 


ds40-1 


Dataspeed40/1 
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tektronix.tek Tektronix 

vt61 DEC vt61 

vt100 DECvtIOO 

hp45 Hewlett-Packard 45 

c100 Concept 100 

The default terminal is none; that is to say, any CRT or normal 
terminal unknown to the system. Also, for terminal type to 
have any meaning, the virtual terminal handlers must be com- 
piled into the operating system. They are available but not 
compiled in the default condition. 

Linedisc, the optional fourth argument, is a character string 
describing which line discipline to use in communicating with 
the terminal. Again the hooks for line disciplines are available 
in the operating system but there is only one presently avail- 
able, the default line discipline, LDISCO. 

When given no optional arguments, getty sets the speed of 
the interface to 9600 baud, specifies that raw mode is to be 
used (awaken on every character), that echo is to be 
suppressed, either parity allowed, new-line characters will be 
converted to carriage return-line feed, and tab expansion per- 
formed on the standard output. It types the login message 
before reading the user's name a character at a time. If a null 
character (or framing error) is received, it is assumed to be 
the result of the user pushing the "break" key. This will cause 
geffy to attempt the next speed in the series. The series that 
geffy tries is determined by what it finds in /etc/gettydefs. 

After the user's name has been typed in, it is terminated by a 
new-line or carriage-return character. The latter results in the 
system being set to treat carriage returns appropriately [see 
/ocr/(2)]. 

The user's name is scanned to see if it contains any lower- 
case alphabetic characters; if not, and if the name is non- 
empty, the system is told to map any future upper-case char- 
acters into the corresponding lower-case characters. 

In addition to the erase and kill characters # and @, getty also 
understands the standard System V erase and kill characters, 
\b and "U. If the user uses a \b as an erase, or "U as a kill 
character, getty sets the standard erase character and/or kill 
character to match. 
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Getty also understands the "standard" ESS protocols for eras- 
ing, killing, and aborting a line, and terminating a line. If geffy 
sees the ESS erase character, _, or kill character, $, or abort 
character, &, or the ESS line terminators, / or ! , it arranges for 
this set of characters to be used for these functions. 

Finally, login is exec'd with the user's name as an argument. 
Additional arguments may be typed after the login name. 
These are passed to login, which will place them in the 
environment [see login (\)]. 

A check option is provided. When getty is invoked with the -c 
option and file, it scans the file as if it were scanning 
/etc/gettydefs and prints out the results to the standard out- 
put. If there are any unrecognized modes or improperly con- 
structed entries, it reports these. If the entries are correct, it 
prints out the values of the various flags. See »ocf/(2) to inter- 
pret the values. Note that some values are added to the flags 
automatically. 

FILES 

/etc/gettydefs 
/etc/issue 

SEE ALSO 

Ct(lC),init(1M), tty(7). 

login(1) in the User's Reference Manual. 

ioctl(2), gettydefs(4), inittab(4) in the Programmer's Reference 

Manual. 

BUGS 

While getty understands simple single character quoting con- 
ventions, it is not possible to quote certain special control 
characters used by geffy. Thus, you cannot login via geffy 
and type a #, @, /, !, _, backspace, "U, "D, or & as part of 
your login name or arguments. Getty uses them to determine 
when the end of the line has been reached, which protocol is 
being used, and what the erase character is. They will always 
be interpreted as having their special meaning. 
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NAME 

hinv - hardware inventory 

SYNOPSIS 

/etc/hinv option 
/etc/hinv hardware-item 

DESCRIPTION 

H/nv provides hardware configuration information. It is used in 
one of two ways. For the first way, an option is given and the 
result is printed on stdout. The other way involves asking 
about a particular hardware item and hinv exiting with if it 
exists and 1 otherwise. 

Option is one of the following: 

-p print hardware configuration. Items are printed one 

per line. 

-c print CPU type. 

-I print FPU type. 

-s print system type. 

-u print maximum number of users. 

-m print total physical memory in bytes. 

-M print total uncached memory in bytes. 

-t print number of tty ports on the system. 

-v print any of the above information verbosely. 

Hardware- item is one of the following: 

80387 80387 floating-point processor. 

W1 167 Weitek 1 167 floating point accelerator system. 

BUGS 

Hinv does not know about PC or PC/AT expansion cards. 
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NAME 

id - print user and group IDs and names 

SYNOPSIS 
id 

DESCRIPTION 

Id outputs the user and group IDs and the corresponding 
names of the invoking process. If the effective and real IDs 
are different, both are printed, 

SEE ALSO 

iogname(l) in the User's Reference Manual. 
getuid(2) in the Programmer's Reference Manual. 



UP-13529 Page 1 



IW1M) 

[This page left blank.] 



Page 2 UP-13529 



Il)LOAD(lM) 






\~y 



NAME 

idload - Remote File Sharing user and group mapping 

SYNOPSIS 

idload [ -n ] [ -g gjules ] [ -u u_rules ] [ directory ] 

DESCRIPTION 

Idload is used on Remote File Sharing server machines to 
build Iranslation tables for user and group IDs. It takes your 
/etc/passwd and /etc/group files and produces translation 
tables for user and group IDs from remote machines, accord- 
ing to the rules set down in the ujules and gjules files. If 
you are mapping by user and group name, you will need 
copies of remote /etc/passwd and /etc/group files. If no 
rules files are specified, remote user and group IDs are 
mapped to MAXUID + 1 (this is an ID number that is one 
higher than the highest number you could assign on your sys- 
tem.) 

By default, the remote password and group files are assumed 
to reside in /usr/nserve/auth.info/otoma/n/nosf/lpasswd! 
group]. The directory argument indicates that some directory 
structure other than /usr/nserve/auth.info contains the 
domain/host passwd and group files. {Host is the name of 
the host the files are from and domain is the domain that host 
is a member of.) 

This command is run automatically when the first remote 
mount is done of a remote resource [see mount (1M)]. 

-n This is used to do a trial run of the ID mapping. 

No translation table will be produced; however, 
a display of the mapping is output to the termi- 
nal (stdout). 

-u ujules The ujules file contains the rules for user ID 
translation. The default rules file is 
/usr/nserve/auth.info/uid.rules. 

-g gjules The gjules file contains the rules for group ID 
translation. The default rules file is 
/usr/nserve/auth.info/gid.rules. 

This command is restricted to the super-user. 

Rules 

The rules files have two types of sections, both optional: 
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global and host. There can be only one global section, 
though there can be one host section for each host you want 
to map. 

The global section describes the default conditions for transla- 
tion for any machines that are not explicitly referenced in a 
host section. If the global section is missing, the default 
action is to map all remote user and group IDs from undefined 
hosts to MAXUID + 1. The syntax of the first line of the global 
section is: 

global 

A host section is used for each client machine or group of 
machines that you want to map differently from the global 
definitions. The syntax of the first line of each host section is: 

host name [ ... J 

where name is replaced by the full name(s) of a host 
(domain.host). 

The format of a rules file is described below. (All lines are 
optional, but must appear in the order shown.) 

global 

default local j transparent 

exclude [remotejd-remotejd] | [remote Jd] 

map I remote Jd: local} 

host domain. hostname [domain.hostname . . .] 

default local J transparent 

exclude tremofej'd-remofejd] J [remote Jd] \ 

[remotejiame] 
map [remote:Tocal] J remote \ all 

Each of these instruction types is described below. 

The line: 

default local \ transparent 

defines the mode of mapping for remote users that are not 
specifically mapped in instructions in other lines. Transparent 
means that all remote user and group IDs will have the same 
numeric value locally unless they appear in the exclude 
instruction. Local can be replaced by a local user name or ID 
to map all users into a particular local name or ID number. If 
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the default line is omitted, all users that are not specifically 
mapped are mapped into a "special guest" login ID. 

The line: 



exclude [remofejd-remofejd] j [remotejdj 
[remofe_name] 



defines remote IDs that will be excluded from the default 
mapping. The exclude instruction must precede any map 
instructions in a block. You can use a range of ID numbers, a 
single ID number, or a single name. (flemofe_name cannot be 
used in a global block.) 

The line: 

map [remote:local] J remote \ all 

defines the local IDs and names that remote IDs and names 
will be mapped into. Remote is either a remote ID number or 
remote name; local is either a local ID number or local name. 
Placing a colon between a remote and a local will give the 
value on the left the permissions of the value on the right. A 
single remofe name or ID will assign the user or group permis- 
sions of the same local name or ID. All is a predefined alias 
for the set of all user and group IDs found in the local 
/etc/passwd and /etc/group files. (You cannot map by 
remote name in global blocks.) 

Note: idload will always output warning messages for map all, 
since password files always contain multiple administrative 
user names with the same ID number. The first mapping 
attempt on the ID number will succeed, all subsequent 
attempts will fail. 

Remote File Sharing doesn't need to be running to use idload. 

EXIT STATUS 

On successful completion, idload will produce one or more 
translation tables and return a successful exit status. If idload 
fails, the command will return an unsuccessful exit status 
without producing a translation table. 

ERRORS 

If (1) neither of the rules files can be found or opened, (2) 
there are syntax errors in the rules file, (3) there are semantic 
errors in the rules file, (4) host information could not be found, 
or (5) the command is not run with super-user privileges, an 
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error message will be sent to standard error. Partial failures 
will cause a warning message to appear, though the process 
will continue. 

FILES 

/etc/passwd 

/etc/group 

/usr/nserve/auth.inf o/doma/n//iosf/[user ', group] 

/usr/nserve/auth.info/vid.rules 

/usr/nserve/auth.info/gid.rules 

SEE ALSO 

mount(lM). 
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NAME 

infocmp - compare or print out terminfo descriptions 

SYNOPSIS 

infocmp [ -d ] [ -c ] [ -n ] [ -I ] [ -L ] [ -C ] [ -r ] 
[-u] 

[ -s d J I | I ! c ] I -v ] I -V J [ -1 ] [ -w width ] 
[ -A directory ] [ -B directory ] [ termname ... ] 

DESCRIPTION 

Infocmp can be used to compare a binary terminfo (4) entry 
with other terminfo entries, rewrite a terminfo (4) description to 
take advantage of the use= terminfo field, or print out a ter- 
minfo (4) description from the binary file [term (4)] in a variety 
of formats. In all cases, the boolean fields will be printed first, 
followed by the numeric fields, followed by the string fields. 

Default Options 

If no options are specified and zero or one fermnames are 
specified, the -I option will be assumed. If more than one 
termname is specified, the -d option will be assumed. 

Comparison Options 

Infocmp compares the terminfo (4) description of the first ter- 
minal termname with each of the descriptions given by the 
entries for the other terminal's termnames. If a capability is 
defined for only one of the terminals, the value returned will 
depend on the type of the capability: F for boolean variables, 
-1 for integer variables, and NULL for string variables. 

-d produce a list of each capability that is different. In this 
manner, if one has two entries for the same terminal or 
similar terminals, using infocmp will show what is different 
between the two entries. This is sometimes necessary 
when more than one person produces an entry for the 
same terminal and one wants to see what is different 
between the two. 

-c produce a list of each capability that is common between 
the two entries. Capabilities that are not set are ignored. 
This option can be used as a quick check to see if the -u 
option is worth using. 

-n produce a list of each capability that is in neither entry. If 
no termnames are given, the environment variable TERM 
will be used for both of the termnames. This can be used 
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as a quick check to see if anything was left out of the 
description. 

Source Listing Options 

The -I, -L, and -C options will produce a source listing for 
each terminal named. 

-I use the terminfo (4) names 

-L use the long C variable name listed in <term.h > . 

-C use the termcap names. 

-r when using -C, put out all capabilities in termcap form. 

If no termnames are given, the environment variable TERM 
will be used for the terminal name. 

The source produced by the -C option may be used directly 
as a termcap entry, but not all of the parameterized strings 
may be changed to the termcap format. Jnfocmp will attempt 
to convert most of the parameterized information, but that 
which it doesn't will be plainly marked in the output and com- 
mented out. These should be edited by hand. 

All padding information for strings will be collected together 
and placed at the beginning of the string where termcap 
expects it. Mandatory padding (padding information with a 
trailing V) will become optional. 

All termcap variables no longer supported by terminfo (4), but 
which are derivable from other terminfo (4) variables, will be 
output. Not all terminfo (A) capabilities will be translated; only 
those variables which were part of termcap will normally be 
output. Specifying the -r option will take off this restriction, 
allowing all capabilities to be output in termcap form. 

Note that because padding is collected to the beginning of the 
capability, not all capabilities are output, mandatory padding is 
not supported, and termcap strings were not as flexible, it is 
not always possible to convert a terminfo (4) string capability 
into an equivalent termcap format. Not all of these strings will 
be able to be converted. A subsequent conversion of the 
termcap file back into terminfo (A) format will not necessarily 
reproduce the original terminfo (4) source. 

Some common terminfo parameter sequences, their termcap 
equivalents, and some terminal types which commonly have 
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such sequences, are: 



S~~\ 



Terminfo 



Termcap Representative Terminals 



f * 



/"""N 



%pl%c 


%. 


adm 


%p1%d 


%d 


hp, ANSI standard, vt100 


%p1%V% + %c 


% + x 


concept 


%i 


%i 


ANSI standard, vt100 


%pi %?%Y% > %t%pi %y % + %; 


%>xy 


concept 


%p2 is printed before %p1 


%r 


hp 


Use= Option 







-u produce a terminfo(4) source description of the first 

terminal termname which is relative to the sum of the 
descriptions given by the entries for the other termi- 
nals termnames. It does this by analyzing the differ- 
ences between the first termname and the other term- 
names and producing a description with use= fields 
for the other terminals. In this manner, it is possible 
to retrofit generic terminfo entries into a terminal's 
description. Or, if two similar terminals exist, but 
were coded at different times or by different people 
so that each description is a full description, using 
infocmp will show what can be done to change one 
description to be relative to the other. 

A capability will get printed with an at-sign (@) if it no longer 
exists in the first termname, but one of the other termname 
entries contains a value for it. A capability's value gets printed 
if the value in the first termname is not found in any of the 
other termname entries, or if the first of the other termname 
entries that has this capability gives a different value for the 
capability than that in the first termname. 

The order of the other termname entries is significant. Since 
the terminfo compiler f/c(1M) does a left-to- right scan of the 
capabilities, specifying two use= entries that contain differing 
entries for the same capabilities will produce different results 
depending on the order in which the entries are given. 
Infocmp will flag any such inconsistencies between the other 
termname entries as they are found. 

Alternatively, specifying a capability after a use= entry that 
contains that capability will cause the second specification to 
be ignored. Using infocmp to recreate a description can be a 
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useful check to make sure that everything was specified 
correctly in the original source description. 

Another error that does not cause incorrect compiled files, but 
will slow down the compilation time, is specifying extra use = 
fields that are superfluous. Infocmp will flag any other term- 
name use= fields that were not needed. 

Other Options 

-s sort the fields within each type according to the argument 
below: 

d leave fields in the order that they are stored in the 
terminfo database. 

i sort by terminfo name. 

I sort by the long C variable name. 

c sort by the termcap name. 

If no -s option is given, the fields printed out will be 
sorted alphabetically by the terminfo name within each 
type, except in the case of the -C or the -L options, which 
cause the sorting to be done by the termcap name or the 
long C variable name, respectively. 

-v print out tracing information on standard error as the pro- 
gram runs. 

-V print out the version of the program in use on standard 
error and exit. 

-1 cause the fields to printed out one to a line. Otherwise, 
the fields will be printed several to a line to a maximum 
width of 60 characters. 

-w change the output to width characters. 

Changing Databases 

The location of the compiled terminfo (A) database is taken 
from the environment variable TERMINFO. If the variable is 
not defined, or the terminal is not found in that location, the 
system terminfo (4) database, usually in lusrlliblterminfo, will 
be used. The options -A and -B may be used to override this 
location. The -A option will set TERMINFO for the first term- 
name and the -B option will set TERMINFO for the other 
termnames. With this, it is possible to compare descriptions 
for a terminal with the same name located in two different 
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databases. This is useful for comparing descriptions for the 
same terminal created by different people. Otherwise the ter- 
minals would have to be named differently in the terminfo(4) 
f~~"\ database for a comparison to be made. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description database 

DIAGNOSTICS 

malloc is out of space! 

There was not enough memory available to process all the 
terminal descriptions requested. Run infocmp several 
times, each time including a subset of the desired term- 
names. 

use = order dependency found: 

A value specified in one relative terminal specification was 
different from that in another relative terminal specifica- 
tion. 

'use = ferm' did not add anything to the description. 

A relative terminal name did not contribute anything to 
f*^'\ the final description. 

***"** must have at least two terminal names for a comparison 

to be done. 

The -u, -d and -c options require at least two terminal 
names. 

SEE ALSO 

tic(lM), curses(3X), term(4), terminfo(4) in the Programmer's 
Reference Manual. 

captoinf o(1 M) in the Administrator's Reference Manual. 
"curses/terminfo" in the System V Operating System 
Programmer's Guide. 

NOTE 

The termcap database (from earlier releases of UNIX System 
V) may not be supplied in future releases. 



^W.*^ 
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NAME 

init, telinit - process control initialization 



O SYNOPSIS 



/etc/init [ 0123456SsQq ] 

/etc/telinit [ 0123456sSQqabc ] 

DESCRIPTION 
Init 

Init is a general process spawner. Its primary role is to create 
processes from information stored in the file /etc/inittab [see 
inittab(4)]. This file usually has init spawn getty's on each line 
that a user may log in on. It also controls autonomous 
processes required by any particular system, 

Init considers the system to be in a run-level at any given 
time. A run-level can be viewed as a software configuration of 
the system where each configuration allows only a selected 
group of processes to exist. The processes spawned by init 
for each of these run-levels is defined in the inittab file. Init 
can be in one of eight run-levels, 0-6 and S or s. The run- 
level is changed by having a privileged user run /etc/init. This 
user-spawned init sends appropriate signals to the original init 
spawned by the operating system when the system was 
rebooted, telling it which run-level to change to. 

Init is invoked inside the 6000/50 system as the last step in the 
boot procedure. First init looks in /etc/inittab for the initde- 
fault entry [see inittab {4)]. If there is one, init uses the run- 
level specified in that entry as the initial run-level to enter. If 
this entry is not in /etc/inittab, init requests that the user enter 
a run-level from the virtual system console, /dev/console. If 
an S or an s is entered, init goes into the SINGLE USER state. 
This is the only run-level that doesn't require the existence of 
a properly formatted /etc/inittab file. If it doesn't exist, then 
by default the only legal run-level that init can enter is the 
SINGLE USER state. In the SINGLE USER state the virtual 
console terminal /dev/console is opened for reading and writ- 
ing and the command /bin/su is invoked immediately. To exit 
from the SINGLE USER state, use either init or telinit to signal 
init to change the run-level of the system. Note that if the 
shell is terminated (via a control-d), init will only re-initialize to 
the SINGLE USER state. 
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When attempting to boot the system, failure of init to prompt 
for a new run-level may be due to the fact that the device 
/dev/console is linked to a device other than the physical sys- H 

tern console (/dev/contty). If this occurs, init can be forced to {^J 
relink /dev/console by typing a delete on the system console 
which is colocated with the processor. 

When init prompts for the new run-level, the operator may 
enter only one of the digits through 6 or the letters S or s. 
If S or s is entered, init operates as previously described in 
the SINGLE USER state with the additional result that 
/dev/console is linked to the user's terminal line, thus making 
it the virtual system console. A message is generated on the 
physical console, /dev/contty, saying where the virtual termi- 
nal has been relocated. 

When init comes up initially and whenever it switches out of 
SINGLE USER state to normal run states, it sets the /ocf/(2) 
states of the virtual console, /dev/console, to those modes 
saved in the file /etc/ioctl.syscon. This file is written by init 
whenever the SINGLE USER state is entered. If this file does 
not exist when init wants to read it, a warning is printed and 
default settings are assumed. 

If a through 6 is entered init enters the corresponding run- 
level. Any other input will be rejected and the user will be re- 
prompted. Note that, on the 6000/50, run-level is for shut- 
ting down the system; run-level 1 is the single-user state; run- 
levels 2 and 3 are available as normal operating states; run- 
level 4 is undefined, run-level 5 is for administration, and run- 
level 6 is for reboot. 

If this is the first time init has entered a run-level other than 
SINGLE USER, init first scans inlttab for special entries of the 
type boot and bootwait. These entries are performed, provid- 
ing the run-level entered matches that of the entry before any 
normal processing of inittab takes place. In this way any spe- 
cial initialization of the operating system, such as mounting file 
systems, can take place before users are allowed onto the -~s 
system. The inittab file is scanned to find all entries that are 
to be processed for that run-level. 

Run-level 2 is defined to contain all of the terminal processes 
and daemons that are spawned in the multi-user environment. 
Hence, it is commonly referred to as the MULTI-USER state. 
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Run-level 3 is defined to start up remote file sharing 
processes and daemons as well as mount and advertise 
remote resources. So, run-level 3 extends multi-user mode 
and is know as the Remote File Sharing state. 

In a MULTI-USER environment, the inittab file is set up so that 
init will create a process for each terminal on the system that 
the administrator sets up to respawn. 

For terminal processes, ultimately the shell will terminate 
because of an end-of-file either typed explicitly or generated 
as the result of hanging up. When init receives a signal telling 
it that a process it spawned has died, it records the fact and 
the reason it died in /etc/utmp and /etc/wtmp if it exists [see 
who(1)]. A history of the processes spawned is kept in 
/etc/wtmp. 

To spawn each process in the inittab file, init reads each entry 
and for each entry that should be respawned, it forks a child 
process. After it has spawned all of the processes specified 
by the inittab file, init waits for one of its descendant 
processes to die, a powerfail signal, or until init is signaled by 
init or telinit to change the system's run-level. When one of 
these conditions occurs, init re-examines the inittab file. New 
entries can be added to the inittab file at any time; however, 
init still waits for one of the above three conditions to occur. 
To get around this, init Q or init q command wakes init to re- 
examine the inittab file immediately. 

If init receives a powerfail signal (SIGPWR) it scans inittab for 
special entries of the type powerfail and powerwait. These 
entries are invoked (if the run-levels permit) before any further 
processing takes place. In this way init can perform various 
cleanup and recording functions during the powerdown of the 
operating system. Note that in the SINGLE-USER state only 
powerfail and powerwait entries are executed. 

When init is requested to change run- levels (via telinit), init 
sends the warning signal (SIGTERM) to all processes that are 
undefined in the target run-level. Init waits 20 seconds before 
forcibly terminating these processes via the kill signal (SIG- 
KILL). 

Telinit 

Telinit, which is linked to letclinit, is used to direct the actions 
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of init. It takes a one-character argument and signals init via 
the kill system call to perform the appropriate action. The fol- 
lowing arguments serve as directives to init . 

i ^ 

0-6 tells init to place the system in one of the run-levels \_y 

0-6. 

a.b.c tells init to process only those /etc/inittab file entries 
having the a, b or c run-level set. These are 
pseudo-states, which may be defined to run certain 
commands, but which do not cause the current run- 
level to change. 

Q,q tells init to re-examine the /etc/in!ttab file. 

s,S tells init to enter the single user environment. When 

this level change is effected, the virtual system tele- 
type, /dev/console, is changed to the terminal from 
which the command was executed. 

FILES 

/etc/inittab 

/etc/utmp 

/etc/wtmp t% . 

/etc/ioctl.syscon 

/dev/console 

/dev/contty 

SEE ALSO 

getty(1M), termio(7). 

login(1), sh(1), who(1) in the User's Reference Manual. 

kill(2), inittab(4), utmp(4) in the Programmer's Reference 

Manual. 

DIAGNOSTICS 

If init finds that it is respawning an entry from /etc/inittab 
more than 10 times in 2 minutes, it will assume that there is an 
error in the command string in the entry, and generate an 
error message on the system console. It will then refuse to 
respawn this entry until either 5 minutes has elapsed or it 
receives a signal from a user-spawned init (telinit). This /— \ 

prevents init from eating up system resources when someone \^J 

makes a typographical error in the inittab file or a program is 
removed that is referenced in the inittab file. 
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WARNINGS 

Telinit can be run only by someone who is super-user or a 
member of group sys. 

BUGS 

Attempting to relink /dev/console with /dev/contty by typing 
a delete on the system console does not work. 
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NAME 

install - install commands 

_ SYNOPSIS 

(_} /etc/install [ -c dira ] [ -f dirb ] [ -i ] [ -n dire ] 

"-" [ -m mode ] [ -u user ] [ -g group ] [ -o ] [ -s ] file 

[ dirx ... ] 

DESCRIPTION 

The install command is most commonly used in "makefiles" 
[see make(1)] to install a file (updated target file) in a specific 
place within a file system. Each file is installed by copying it 
into the appropriate directory, thereby retaining the mode and 
owner of the original command. The program prints mes- 
sages telling the user exactly what files it is replacing or creat- 
ing and where they are going. 

If no options or directories (dirx ...) are given, install will 
search a set of default directories (/bin, /usr/bin, /etc, /lib, 
and /usr/lib, in that order) for a file with the same name as 
file. When the first occurrence is found, install issues a mes- 
^ sage saying that it is overwriting that file with file, and 

l % ^J proceeds to do so. If the file is not found, the program states 

this and exits without further action. 

If one or more directories (dirx ...) are specified after file, 
those directories will be searched before the directories speci- 
fied in the default list. 

The meanings of the options are: 

-c dira Installs a new command (file) in the directory speci- 
fied by dira, only if it is not found. If it is found, 
install issues a message saying that the file already 
exists, and exits without overwriting it. May be 
used alone or with the -s option. 

-f dirb Forces file to be installed in given directory, 

whether or not one already exists. If the file being 

installed does not already exist, the mode and 

.—, owner of the new file will be set to 755 and bin, 

( j respectively. If the file already exists, the mode 

*"*' and owner will be that of the already existing file. 

May be used alone or with the -o or -s options. 
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-i Ignores default directory list, searching only 

through the given directories (dirx ...). May be 
used alone or with any other options except -c and 
-f. 

-n dire If file is not found in any of the searched direc- 
tories, it is put in the directory specified in dire. 
The mode and owner of the new file will be set to 
755 and bin, respectively. May be used alone or 
with any other options except -c and -f. 

-m mode The mode of the new file is set to mode. Only 
available to the super-user. 

-u user The owner of the new file is set to user. Only avail- 
able to the super-user. 

-g group The group ID of the new file is set to group. Only 
available to the super-user. 

-o If file is found, this option saves the "found" file by 

copying it to OLDfi/e in the directory in which it was 
found. This option is useful when installing a fre- 
quently used file such as /bin/sh or /etc/getty, 
where the existing file cannot be removed. May be 
used alone or with any other options except -c. 

•s Suppresses printing of messages other than error 

messages. May be used alone or with any other 
options. 

SEE ALSO 

make(1) in the Programmer's Reference Manual. 



Page 2 



UP-13529 



KCRASH(IM) 



NAME 

kcrash - examine system images 

SYNOPSIS 
( ) kcrash [-w] dumpfile [ namelist ] 

DESCRIPTION 

The kcrash program, similar to the eras/7 (1M) program, exam- 
ines system crash dumps. Unlike crash, the kcrash command 
interface is based on the kernel debugger [see kdb(lM)]. All 
commands accepted by the kernel debugger can be used 
identically in kcrash, with the following exceptions: 

• I/O commands (such as in, out, and so forth) do not work. 

• Execution commands (go, tr, to) do not work. 

• Breakpoint commands do nothing. 

• The re command does not work. 

Commands that modify memory (actually modify the crash 
dump file) work only if the -w flag is present in the command 
line. 

\^J In addition, the following commands work only in kcrash (not 

in the kernel debugger): 

< < filename 

Read and execute commands from the given file. Note 
that the < < command is like the combination of 
mkdbcmd^M) and the re command in the kernel 
debugger. 

!! shell-command 

Executes the given shell command. 

qq Quits kcrash. 

FILES 

/crash/crash.* crash dumps 



o 
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/crash/macros/* macros that are useful for kernel debugging 
/unix default namelist 

SEE ALSO 

crash(1M),kdb(lM). 



i. 
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NAME 

kdb - Kernel Debug Monitor 

DESCRIPTION 

The 6000/50 Debug Monitor is a simple monitor that resides in 
the System V kernel and allows the programmer to examine 
and modify memory, disassemble instructions, download and 
execute programs, set breakpoints, and single-step instruc- 
tions. 

After loading the debug monitor with /do7v(1M), the monitor is 
entered by typing control-B on the console [see cons (1M)]. 

Commands 

All monitor commands are two characters, followed by zero or 
more arguments. In the following descriptions, optional argu- 
ments are enclosed in square brackets. Arguments are 
separated by spaces or commas, and each argument must be 
one of the following: 

1. A hex number. 

2. A percent sign followed by a register name, meaning the 
contents of that register, such as %eax, %esp, %eflags. 
Only 32-bit registers are allowed; 8- or 16-bit registers are 
invalid. 

A percent sign followed by a breakpoint number, meaning the 
address referred to by the that breakpoint, such as %bx. 

3. A dollar sign, meaning the address of the last memory 
location that was displayed. 

4. The name of a kernel symbol. This works only if the ker- 
nel debugger has been loaded with the System V symbol 
table via the mkdbsym (1 M) command. 

5. Any of the above combined by using the usual arithmetic 
operators (+-*/% & | *) or the relational operators 
used as used in the C programming language (= = ! = 
<> < = > =). All operators have equal precedence. 
Use parentheses to force a particular order of evaluation. 

Input Commands 

The debug monitor prompts with K>. This prompt indicates 
the monitor is ready to accept any of the commands 
described below. Input characters can be erased with BACK- 
SPACE or DEL. An entire input line can be erased with 
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control-U or control-X. 

After a breakpoint or debug trap, the monitor prints a status 
line describing the trap, immediately followed by the K 
prompt, and is again ready to accept commands. In the case 
of a trace trap, the monitor automatically supplies the 
expected command, tr. If you want to enter a different com- 
mand, erase the tr and retype a new command. 

During any of the display, modify, examine or write com- 
mands, you can enter one of the following: 

RETURN 

Moves to the next item. 

+ n Moves to the nth next item. 

Moves to the previous item. 

•n Moves to the nth previous item. 

=addr 

Moves to the item at address addr. Only valid when 
operating on memory, not on registers. 

n Changes the value of the item to n. Only valid for modify 
or write commands, not display or examine. The mi com- 
mand allows you to enter multiple numbers separated by 
spaces, to change more than one byte. 

q (Or any character other than + - = or a hex number). 
Exits the command and returns to the monitor prompt. 

Display Commands 

These commands allow you to examine memory only. This 
prevents accidental modification of system memory when in 
the debug monitor. 

dl addr [ count ] 

Displays memory as longs (4 byte hex integers), 32 bytes 
at a time. If a count is given, memory is displayed 32 * 
counf bytes at a time. 
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dw addr [ count ] 

Displays memory as words (2 byte hex integers), 32 bytes 
at a time. 

v_ db acfdr [ counf ] 

Displays memory as bytes (1 byte hex integers), 32 bytes 
at a time. 

dl [ addr ] 

Displays memory as disassembled instructions. The 
default addr is the contents of %eip. 

dr Displays the CPU general registers. 

dR Displays the CPU "special" registers (debug, control, and 
table base registers). 

dy addr [ count ] 

Similar to dl, but displays the longs in symbolic form, if 
possible. 

se start end pattern [ mask ] 

Searches for the given pattern in the range of addresses 
f^\ starting at sfarf, up to (but not including) end. The 

%% -^ / search is performed on longs. If a mask is given, only 

those bits corresponding to 1 bits in the mask are signifi- 
cant in the search. 

Examine Commands 
el addr 

Examines memory as longs, one at a time. 

ew addr 

Examines memory as words, one at a time. 

eb addr 

Examines memory as bytes, one at a time. 

et [ addr ] 

Examines memory as disassembled instructions. (Same 
as di.) 

er Examines CPU general registers, one at a time. 

X_J eR Examines the CPU special registers, one at a time. 

Modify Commands 
ml addr 

Examines and optionally modifies memory, as longs. 
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mw addr 

Examines and optionally modifies memory, as words. 

mb addr 

Examines and optionally modifies memory, as bytes. 

mi [ addr ] 

Examines memory as instructions and optionally modifies 
(as bytes). 

mr Examines and optionally modifies the CPU registers. 

mR Examines and optionally modifies the CPU special regis- 
ters. 

Write Commands 
wl addr 

Writes memory as longs, without examining. 

ww addr 

Writes memory as words, without examining. 

wb addr 

Writes memory as bytes, without examining. 

I/O Commands 
in addr 

Reads a byte from the specified I/O port. 

iw addr 

Reads a word (2 bytes) from the specified I/O port. 

il addr 

Reads a longword (4 bytes) from the specified I/O port. 

ou addr value 

Outputs a byte (value) to the specified I/O port. 

ow addr value 

Outputs a word (value) to the specified I/O port. 

ol addr value 

Outputs a longword (value) to the specified I/O port. 

Execute Commands 

go [ addr ] 

Starts execution. 

tr [ addr ] 

Trace: single step one instruction. 
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to [ addr } 

Trace over: single step over "call" instructions. 

Breakpoint Commands 

A breakpoint invokes the debug monitor just prior to the exe- 
cution of a specified instruction. There are a total of sixteen 
instruction breakpoints available. 

br [ addr ] 

Sets a breakpoint. The default address is the contents of 
%eip. 

be [ addr ] 

Clears (removes) a breakpoint. 

bC [ addr ] 

Clears (removes) all breakpoints. 

bx [ addr ] 

Sets a temporary (one-shot) breakpoint. 

bo [ addr ] 

Turns a breakpoint on or off. If a breakpoint is turned off, 
it acts as though it were cleared, but the breakpoint 
\^J remains in the breakpoint table. 

bp Displays breakpoints. 

Memory Breakpoint Commands 

A memory breakpoint invokes the debug monitor when a 
specified memory location is referenced. There are a total of 
four memory breakpoints available. 

ur num type [ addr ] 

Sets a memory breakpoint. Num must be to 3, addr is 
the breakpoint address, and type gives the type of 
memory access that will trigger the breakpoint. Valid 
types are: 

Execute 

10 Byte write 

1 1 Byte read/write 

20 Word write 

21 Word read/write 

40 Long write 

41 Long read/write 
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Note that the first digit specifies the breakpoint length 
and the second specifies the access type (write-only or 
read/write). The breakpoint is global unless the type is 
ORed with 100, which makes it local; or with 200, which 
makes it global and local. For example, 140 specifies a 
local long write-only breakpoint. 

ux num type [ addr ] 

Like ur, but sets a temporary (one-shot) breakpoint. 

uc num 

Clears a memory breakpoint. 

up Prints all memory breakpoints. 

Miscellaneous Commands 

bt [ addr ] 

Displays a stack backtrace, using addr as a frame pointer. 
The default address is the contents of %ebp. This works 
only with C language routines in protected mode. 

fl start end value 

Fills memory from address start up to (but not including) 
address end with the byte value. 

pg "string" [ args... ] 

Prints the string. Percent signs in the string are treated 
as in printf (3S): %d, %u, %x, %o, %b, %s, %s, %c are 
supported. 

In addition, %y prints its argument in symbolic form, if possi- 
ble. 

re Reads any commands that have been loaded previously 
with the mkdbcmd (1M) command. 

rg [ addr ] 

Changes the pointer to the "register save area," from 
which all references to CPU registers, such as the dr com- 
mand, and explicit reference, such as %ebx, or an implicit 
reference, such as the di command with no argument, 
retrieve registers. Normally, the register save area is set 
up automatically, but you can use a different set of regis- 
ters when you use rg to change the pointer. 

P9[n] 

If n is 0, turns paging off. If n is 1, turns paging on. If n 
is missing, it simply reports whether paging is on or off. If 
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paging is off, the monitor interprets all addresses as phy- 
sical addresses. If paging is on, addresses are inter- 
preted as linear (virtual) addresses. (Breakpoints are 
"~ always linear addresses.) 

ma addr 

Displays the page directory and page table entries used 
to map the given linear address to a physical address. 
This behaves the same whether paging is on or off. 

c3 addr 

Uses the given physical address as the base of the page 
directory for translating linear to physical addresses. This 
address is obtained from the special register CR3 if no c3 
command is given. 

pr addr 

Prints the value of the address given as an argument. 
This is most useful if addr is an expression (see the earlier 
discussion of arguments). 

ds addr 
s~~ \ Prints the value of the address as an offset from the 

U nearest symbol. 

sy [ n ] [ max ] 

If n is 0, turns symbolic display off. If n is 1, turns sym- 
bolic display on. If n is missing, it simply reports whether 
symbolic display is on or off. If max is given, it specifies 
the maximum offset for printing symbols. For example, if 
max is 1000, a symbol may be displayed in the form 
name+NNN, where NNN is 1 through 1000, but if NNN 
would be greater than 1000, the non-symbolic display for- 
mat is used. 

he or ?? 

Lists the monitor commands. 

ve Prints the version number of the monitor. 

Macro Commands 

,— ^ dm "name" arg-count 

\ w j Defines a MACRO, with the given name and the specified 

number of arguments. The cm command (described 
below) can be used subsequently to invoke the macro. 
After you enter the dm command, the debugger prompts 
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with mao for the body of the macro. Any debugger 
commands can be entered as the body of the macro, 
although interactive commands, such as dl are not recom- 
mended. The expression $n, where n is a digit from 1 to 
9, is replaced on invocation with the nth argument to the 
macro. Entry of the macro body is terminated by a period 
(.) anywhere in the macro body. Include a period in the 
macro body by preceding the character with a backslash 
\.. 

cm "name" args 

Calls a macro. The number of arguments must match the 
number given when the macro was defined. The effect is 
as if the body of the macro were entered in place of the 
cm command. 

em "name" 

Erases (deletes) the named macro. 

im ["name"] 

Lists the named macro. If the macro name is omitted, 
lists all macros. 

nx Repeats the call to the previously invoked macro. The 
arguments used ar the ones used on the previous call, 
possibly modified by any intervening sa commands. 

sa n value 

Sets the nth macro argument to the given value. The 
value of n should be between 1 and 9. Useful within a 
macro to set up the arguments for the next call through 
an nx commmand. 

ec [n] 

If n is 1, macros are echoed when they are invoked. If n 
is (the default), macros are not echoed. If n is missing, 
the status of the echo flag is printed. If the ec command 
is given within a macro body, it is in effect only for that 
macro. 

Conditional Commands 
IF expr EL FI 

If the expression evaluates to zero, all commands up to 
the matching EL or FI are skipped. If the expression is 
non-zero, execution proceeds normally to the matching 
FI, unless a matching EL is found, in which case, 
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commands between the EL and the FI are skipped. Dur- 
ing any of this "skipping," the prompt changes from K> 
to \mK> to indicate that the commands are being read 
but not executed. 

SEE ALSO 

cons(lM), lddrv(1M), mkdbsym(lM) in the Administrator's 
Reference Manual. 

BUGS 

If you try to go at the exact address where a breakpoint is 
set, the breakpoint will not trigger. 

The disassembler works only with protected mode (32 bit) 
instructions. It does not know how to disassemble 16 bit 
instructions. 
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NAME 

kifla.II - kill all active processes 

SYNOPSIS 
l^ ) /etc/killall [ signal ] 

DESCRIPTION 

Killall is used by /etc/shutdown to kill all active processes not 
directly related to the shutdown procedure. 

Killall terminates ail processes with open files so that the 
mounted file systems will be unbusied and can be unmounted. 

Killall sends signal [see W//(1)] to all processes not belonging 
to the above group of exclusions. If no signal is specified, a 
default of 9 is used. 

FILES 

/etc/shutdown 

SEE ALSO 

fuser(1M), shutdown (1M). 

kill(1), ps(1) in the User's Reference Manual. 

signal (2) in the Programmer's Reference Manual. 

WARNINGS 

The killall command can be run only by the super-user. 
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NAME 

labelit - provide labels for file systems 

SYNOPSIS 

/etc/labelit special [ fsname volume [ -n ] [ -t ] ] 

DESCRIPTION 

Labelit can be used to provide labels for unmounted disk file 
systems or file systems being copied to tape. The «n option 
provides for initial labeling only (this destroys previous con- 
tents). The -t option puts tape headers on media other than 
tape. 

With the optional arguments omitted, /abe//f prints current 
label values. 

The special name should be the physical disk section (such as 
/dev/dsk/c0d0s6), or the cartridge tape (for example, 
/dev/rmtO). The device may not be on a remote machine. 

The fsname argument represents the mounted name (for 
example, root, u1, and so forth) of the file system. 

Volume may be used to equate an internal name to a volume 
name applied externally to the disk pack, diskette or tape. 

For file systems on disk, fsname and volume are recorded in 
the superblock. 

SEE ALSO 

sh(1) in the User's Reference Manual, 

fs(4) in the Programmer's Reference Manual. 

WARNINGS 

Labelit applied to a mounted file system will appear to 
succeed, but the next reboot or umount will remove the label. 



UP-13529 Page 1 



LABELIT(IM) 



[This page left blank.] 



Page 2 UP-13529 



Ll)I)RV(IM) 



NAME 

/etc/lddrv/lddrv - manage loadable drivers 

SYNOPSIS 
{ } Iddrv [ -m master ] [ -abdqsuv ] [ devname [ subdevs ] 

1 

Iddrv -a [ v ] [ -k ] [ -m master ] [ -o dfile ] devname 
[ subdevs ] 



/*% 



-k ] [ -m master ] devname 
-k ] [ -m master ] devname 
-k ] [ -m master ] devname 
-m master ] devname 
-m master ] 



Iddrv -d [ v ] 
Iddrv -b [ v ] 
Iddrv -u [ v ] 
Iddrv -q [ v ] 
Iddrv -s [ v ] 

DESCRIPTION 

Lddrv allocates/deallocates space for a specified driver, 
, loads/unloads a specified driver, and returns the status of 

specified driver(s). 

The v argument prints verbose information on the screen. 

% — J The -m option allows overriding the default master file 

(/etc/master). The -k flag causes mkdbsym (1M) to be run 
automatically to update the kernel debugger's symbol table. 
Use -o dfile to specify the name of the file that contains the 
driver's executable code; if omitted, executable code is placed 
in the file devname. The devname argument is the name of 

* the driver. 

■ J 

Devname must correspond to the first field in the master file. 
In addition, the relocatable driver code must be in a file 
named devname. o. More than one major device may be 
plugged with a single invocation of Iddrv by specifying up to 
three subdevices. 

The options are: 

-a Allocate space for and load the driver. 

*f"*') -d Unload the driver and deallocate its space. 

-b Load (bind) the driver. 

-u Unload the driver. 
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-q Return the status of a particular loadable driver. 
-s Return the status of all loadable drivers. 

EXAMPLES 

A status report for all drivers could look like: 

DEVNAME ID TYPE BLK CHAR SIZE ADDR FLAGS 

fpe 1 SFTORV - - 0X5000 OxCIOEOOOO ALLOC BOUND 
lp 2 DRIVER - 52 0x7000 0x01210000 ALLOC BOUND 

FILES 

/etc/master default master file 

/etc/drvtbl loadable driver table 

/etc/lddrv contains Iddrv and loadable drivers 

/etc/lddrv/unix.sym 

contains kernel symbols 

SEE ALSO 

drvload(IM), mkdbsym(IM), mkifile(IM), nmlmaint(IM), 

drivers(7). 

syslocal(2), master(4) in the Programmer's Reference Manual. 
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NAME 

link, unlink - link and unlink files and directories 

SYNOPSIS 



( ' /etc/link filel file2 



C 



/etc/unlink file 

DESCRIPTION 

The link command is used to create a file name that points to 
another file. Linked files and directories can be removed by 
the unlink command; however, it is strongly recommended 
that the rm(1) and rmdir [see rm(1)] commands be used 
instead of the unlink command. 

The only difference between /n(1) and link/unlink is that the 
latter do exactly what they are told to do, abandoning all error 
checking. This is because they directly invoke the link (2) and 
unlink (2) system calls. 

SEE ALSO 

rm(1) in the User's Reference Manual. 

Iink(2), unlink(2) in the Programmer's Reference Manual. 

WARNINGS 

These commands can be run only by the super-user. 
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NAME 

Ipadmin - configure the LP spooling system 

SYNOPSIS 

/usr/lib/lpadmin -pprinter [ options ] 

/usr/lib/lpadmin -xdest 

/usr/lib/lpadmin -d [ dest ] 

DESCRIPTION 

Lpadmin configures line printer (LP) spooling systems to 
describe printers, classes, and devices. It is used to add and 
remove destinations, change membership in classes, change 
devices for printers, change printer interface programs, and 
change the system default destination. Lpadmin may not be 
used when the LP scheduler, lpsched(1M), is running, except 
where noted below. 

Exactly one of the -p, -d, or -x options must be present for 
every legal invocation of Ipadmin. 

•pprinter names a printer to which all of the options below 
refer. If printer does not exist then it will be 
created. 

-xdesf removes destination dest from the LP system. If 

desf is a printer and is the only member of a 
class, then the class will be deleted, also. No 
other options are allowed with -x. 

-d[desr] makes desf, an existing destination, the new sys- 
tem default destination. If desf is not supplied, 
then there is no system default destination. This 
option may be used when /psched (1M) is run- 
ning. No other options ate allowed with -d. 

The following options are only useful with -p and may appear 
in any order. For ease of discussion, the printer will be 
referred to as P below. 

•cclass inserts printer P into the specified class. Class 

will be created if it does not already exist. 

•eprinter copies an existing printer's interface program to 
be the new interface program for P. 

-h indicates that the device associated with P is 

hardwired. This option is assumed when adding 
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a new printer unless the -I option is supplied. 

-{interface establishes a new interface program for P. Inter- 
face is the path name of the new program. 

-I indicates that the device associated with P is a 

login terminal. The LP scheduler, Ipsched, dis- 
ables all login terminals automatically each time it 
is started. Before re-enabling P, its current dev- 
ice should be established using Ipadmin. 

■mmodel selects a model interface program for P. Model 
is one of the model interface names supplied with 
the LP Spooling Utilities (see Models below). 

-rclass removes printer P from the specified class. If P 

is the last member of the class, then the class 
will be removed. 

•vdevice associates a new device with printer P. Device is 
the pathname of a file that is writable by Ip. Note 
that the same device can be associated with 
more than one printer. If only the -p and -v 
options are supplied, then Ipadmin may be used 
while the scheduler is running. 

Restrictions 

When creating a new printer, the -v option and one of the -e, 
-i, or -m options must be supplied. Only one of the -e, -i, or 
-m options may be supplied. The -h and -I keyletters are 
mutually exclusive. Printer and class names may be no longer 
than 14 characters and must consist entirely of the characters 
A-Z, a-2, 0-9, and _ (underscore). 

Models 

Model printer interface programs are supplied with the LP 
Spooling Utilities. They are shell procedures which interface 
between Ipsched and devices. All models reside in the direc- 
tory /usr/spool/lp/model and may be used as is with Ipadmin 
-m. Copies of model interface programs may also be modi- 
fied and then associated with printers using Ipadmin -i. The 
following describes the models and lists the options which 
may be given on the Ip command line using the -o keyletter 
for each model: 
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Iqp40 Letter quality printer using XON/XOFF protocol at 
9600 baud. 

dpq10 Dot matrix draft quality printer using XON/XOFF 
protocol at 9600 baud. 

dumb Interface for a line printer without special functions 
and protocol. Form feeds are assumed. This is a 
good model to copy and modify for printers which 
do not have models. 

1640 DIABLO 1640 terminal running at 1200 baud, using 

XON/XOFF protocol. Options: 

-12 12- pitch (10- pitch is the default). 

-f Do not use the 450(1) filter. The output has 
been pre-processed by 450(1). 

hp Hewlett-Packard 2631A line printer at 2400 baud. 

Options: 

-c Compressed print. 

-e Expanded print. 

prx Printronix P300 or P600 printer using XON/XOFF 

protocol at 1200 baud. 

5310 AT&T 5310/20 Matrix Printer. Options: 

-f Do not use filter. 

-nc Do not produce cover and trailer sheets. 

-16 or -18 

Set lines per inch accordingly. 

When using this model, set the printer options as 
follows: 





WRAP: YES 


BAUD: 9600 




EMUL: ANSI 


FLOW: CHAR 




LFON: NO 


DC24: NO 




CRON: NO 


DEOT: NO 




CMOD: NOMD 


ECHO: NO 




PRTY: EVEN 


ABAA: NO 


ethernet 


Remote print via 


Ethernet. 


f450 


Interface for DASI 450 terminal. All output is 




passed througl- 


i the lusr/bin/450 filter or the 
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fusr/lib/etx filter (if processed already by 450 driv- 
ing table or filter). If the filter is not executable, this 
interface disables the Ip printer which it was called 
to service. 

ph.daps Interface to Autologic APS-5 phototypesetter. Out- 
put is passed through filter daps, which is also a 
command. 

pprx Interface for printronix line printer with parallel 

interface. All output is passed through the 
lusr/liblpprx filter. If the filter is not executable, 
this interface disables the Ip printer which it was 
called to service. 

serial Serial line printer. This interface is identical to the 
dumb model, except that it issues an stty command 
that sets the following serial port characteristics: 8 
bits, no parity, 9600 baud, XON/XOFF, pass tabs 
through to printer. 

EXAMPLES 

An Iqp40 printer called prl can be added to the Ip configura- 
tion with the command: 

/usr/lib/lpadmin -pprl - v/dev/contty -mlqp<40 

Assuming there is an existing Hewlett-Packard 2631 line 
printer named hp2, it will use the hp model interface after the 
command: 

/usr/lib/lpadmin -php2 -mhp 

To obtain compressed print on hp2, use the command: 

lp -dhp2 -o-c files 

FILES 

/usr/spool/lp/* 

SEE ALSO 

accept(1M), lpsched(1M). 

enable(1), lp(1), lpstat(1) in the User's Reference Manual. 
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NAME 

Ipsched, Ipshut, Ipmove - start/stop the LP scheduler and 
move requests 

SYNOPSIS 

/usr/lib/lpsched 

/usr/lib/lpshut 

/usr/lib/lpmove requests dest 

/usr/lib/lpmove destl dest2 

DESCRIPTION 

Lpsched schedules requests taken by /p(1) for printing on line 
printers (LP's). 

Lpshut shuts down the line printer scheduler. All printers that 
are printing at the time Ipshut is invoked will stop printing. 
Requests that were printing at the time a printer was shut 
down will be reprinted in their entirety after Ipsched is started 
again. All LP commands perform their functions even when 
Ipsched is not running. 

Lpmove moves requests that were queued by /p(1) between 
LP destinations. This command may be used only when 
Ipsched is not running. 

The first form of the command moves the named requests to 
the LP destination, dest. Requests are request IDs as 
returned by /p(l). The second form moves all requests for 
destination destl to destination dest2. As a side effect, Ip (1) 
will reject requests for destl. 

Note that Ipmove never checks the acceptance status [see 
accept (1M)j for the new destination when moving requests. 

FILES 

/usr/spool/lp/* 

/etc/rc2.d/SXXIp initialization for Ip or Ipr spooling system 

SEE ALSO 

accept(1M), lpadmin(1M). 

enable(1), lp(1), lpstat(1) in the User's Reference Manual. 
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NAME 

Ipset - set parallel line printer options 

SYNOPSIS 

Ipset [ -j indent ] [ -c columns ] [ -I lines ] 

DESCRIPTION 

Lpsef sets the translation options for the parallel printer inter- 
face. The options set the indent (-1), number of columns (-c), 
and lines per page (-1); the interpretation of these options by 
the interface is described under lp(7). 

With no options, Ipset reports the current values. Initially, the 
values are: an indent of 4, 132 columns, 66 lines per page. 

FILES 

/dev/lp? 

/etc/rc2.d/SXXIp initialization for Ip or Ipr spooling system 

SEE ALSO 

lp(7). 

DIAGNOSTICS 

Self explanatory, except that "parallel printer not properly con- 
nected" may actually mean that the printer is in use. 
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NAME 

masterupd - update the master file 

SYNOPSIS 

masterupd [ flags ] [ devicename ] 

DESCRIPTION 

Masterupd is used to manipulate the /etc/master file. 
Although the file can be directly edited, it is often more con- 
venient to use the features of masterupd. The flags are; 

-a Add a device to the master file. The devicename must be 
specified. Also, the -f flag must be given to specify the 
device's functions. 

-d Delete a device from the master file. Only the de- 
vicename need be given. If the device is not found in the 
master file, the command silently terminates with no error 
message. 

-q Query the master file for a particular device. The de- 
vicename must be given. Also, one of the device type 
flags (see below) must be given to specify what type of 
device to look for. If a block or character device is speci- 
fied, the major number is written to standard output. If a 
line discipline is specified, the line discipline index is out- 
put. If a software module is specified, the software ID is 
output. If the device cannot be found in the master file, a 
question mark is output. 

-v Verify the consistency of the master file. 

Any or all of the above flags may be used together. If -a is 
used with -d, the device is deleted from the master file first, 
then added again. If the -q option is used with -a and/or -d, it 
reports the major number of the device after the 
addition/deletion. 

The -a flag and the -q flag require a device type to be given. 
The following flags specify the device type: 

■b block device 

-c character device 

-I line discipline 

-m stream module 
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-s software module 

-r required device 

Other flags that may be used with -a are: 

-f followed by a string of function letters, specifies functions 
for the device. See master (4) for a description of the 
letters. 

-p followed by a string, specifies a prefix for the device. 
Default is the device name. 

-i followed by a decimal integer, specifies an init parameter 
for the device. Up to three -i flags may be given to 
specify up to three init parameters which are appended to 
the end of the line in the master file. 

The -M flag may be used to specify an alternate master file. 

EXAMPLES 

To install a new character device driver named "xyz" (with the 
prefix "xyz") and functions open, close, read, write, ioctl, init, 
and release: 

masterupd -a -c -f ocrwi xyz 

As a more realistic example, the following script does the 
same, but first deletes the driver if it already in the master file 
and uses the query feature to make /dev files for the newly 
assigned character major number: 

MAJ='masterupd -daq -c -f ocrwi xyz* 

if [ "SMAJ" = "?" ] 

then 

echo "Error" 
else 

mknod /dev/xyzO c SMAJ 

mknod /dev/xyz1 c SMAJ 1 

fi 

SEE ALSO 

config(1M). 

master(4) in the Programmer's Reference Manual. 
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NAME 

mkdbcmd - load commands into the kernel debuggerq 

DESCRIPTION 

The 6000/50 Debug Monitor is a simple monitor that resides in 
the System V kernel and allows the programmer to examine 
and modify memory, disassemble instructions, download and 
execute programs, set breakpoints, and single-step instruc- 
tions. 

After loading the debug monitor with /c/drv(1M), the monitor is 
entered by typing control-B on the console [see cons (1M)]. 

Commands 

All monitor commands are two characters, followed by zero or 
more arguments. In the following descriptions, optional argu- 
ments are enclosed in square brackets. Arguments are 
separated by spaces or commas, and each argument must be 
one of the following: 

1. A hex number. 

2. A percent sign followed by a register name, meaning the 
contents of that register, such as %eax, %esp, %eflags. 
Only 32-bit registers are allowed; 8- or 16-bit registers are 
invalid. 

A percent sign followed by a breakpoint number, meaning the 
address referred to by the that breakpoint, such as %bx. 

3. A dollar sign, meaning the address of the last memory 
location that was displayed. 

4. The name of a kernel symbol. This works only if the ker- 
nel debugger has been loaded with the System V symbol 
table via the mkdbsym (1M) command. 

5. Any of the above combined by using the usual arithmetic 
operators (+•*/% & J *) or the relational operators 
used as used in the C programming language (= = ! = 
<> <= >=). All operators have equal precedence. 
Use parentheses to force a particular order of evaluation. 

Input Commands 

The debug monitor prompts with K>. This prompt indicates 
the monitor is ready to accept any of the commands 
described below. Input characters can be erased with BACK- 
SPACE or DEL. An entire input line can be erased with 
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control-U or control-X. 

After a breakpoint or debug trap, the monitor prints a status 
line describing the trap, immediately followed by the K 
prompt, and is again ready to accept commands. In the case 
of a trace trap, the monitor automatically supplies the 
expected command, tr. If you want to enter a different com- 
mand, erase the tr and retype a new command. 

During any of the display, modify, examine or write com- 
mands, you can enter one of the following: 

RETURN 

Moves to the next item. 

+ n Moves to the nth next item. 

Moves to the previous item. 

-n Moves to the nth previous item. 

=adcfr 

Moves to the item at address addr. Only valid when 
operating on memory, not on registers. 

n Changes the value of the item to n. Only valid for modify 
or write commands, not display or examine. The mi com- 
mand allows you to enter multiple numbers separated by 
spaces, to change more than one byte. 

q (Or any character other than + - = or a hex number). 
Exits the command and returns to the monitor prompt. 

Display Commands 

These commands allow you to examine memory only. This 
prevents accidental modification of system memory when in 
the debug monitor. 

dl addr [ count ] 

Displays memory as longs (4 byte hex integers), 32 bytes 
at a time. If a count is given, memory is displayed 32 * 
count bytes at a time. 
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dw addr [ count ] 

Displays memory as words (2 byte hex integers), 32 bytes 
at a time. 

db addr [ count ] 

Displays memory as bytes (1 byte hex integers), 32 bytes 
at a time. 

dl [ addr ] 

Displays memory as disassembled instructions. The 
default addr is the contents of %eip. 

dr Displays the CPU general registers. 

dR Displays the CPU "special" registers (debug, control, and 
table base registers). 

dy addr [ count ] 

Similar to dl, but displays the longs in symbolic form, if 
possible. 

se sfart end pattern [ mask ] 

Searches for the given pattern in the range of addresses 
starting at start, up to (but not including) end. The 
search is performed on longs. If a mask is given, only 
those bits corresponding to 1 bits in the mask are signifi- 
cant in the search. 

Examine Commands 
el addr 

Examines memory as longs, one at a time. 

ew addr 

Examines memory as words, one at a time. 

eb addr 

Examines memory as bytes, one at a time. 

ei [ addr ] 

Examines memory as disassembled instructions. (Same 
as di.) 

er Examines CPU general registers, one at a time. 

eR Examines the CPU special registers, one at a time. 

Modify Commands 
ml addr 

Examines and optionally modifies memory, as longs. 
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mw addr 

Examines and optionally modifies memory, as words. 

mb addr 

Examines and optionally modifies memory, as bytes. 

ml [ addr ] 

Examines memory as instructions and optionally modifies 
(as bytes). 

mr Examines and optionally modifies the CPU registers. 

mR Examines and optionally modifies the CPU special regis- 
ters. 

Write Commands 
wl addr 

Writes memory as longs, without examining. 

ww addr 

Writes memory as words, without examining. 

wb addr 

Writes memory as bytes, without examining. 

I/O Commands 
In addr 

Reads a byte from the specified I/O port. 

Iw addr 

Reads a word (2 bytes) from the specified I/O port. 

il addr 

Reads a longword (4 bytes) from the specified I/O port. 

ou addr value 

Outputs a byte (value) to the specified I/O port. 

ow addr value 

Outputs a word (value) to the specified I/O port. 

ol addr value 

Outputs a longword (value) to the specified I/O port. 

Execute Commands 
go [ addr ] 

Starts execution. 



tr [ addr ] 

Trace: single step one instruction. 
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to [ addr ] 

Trace over: single step over "call" instructions. 

Breakpoint Commands 

A breakpoint invokes the debug monitor just prior to the exe- 
cution of a specified instruction. There are a total of sixteen 
instruction breakpoints available. 

br [ addr ] 

Sets a breakpoint. The default address is the contents of 
%eip. 

be [ addr ] 

Clears (removes) a breakpoint. 

bC [ addr ] 

Clears (removes) all breakpoints. 

bx [ addr ] 

Sets a temporary (one-shot) breakpoint. 

bo [ addr ] 

Turns a breakpoint on or off. If a breakpoint is turned off, 
it acts as though it were cleared, but the breakpoint 
remains in the breakpoint table. 

bp Displays breakpoints. 

Memory Breakpoint Commands 

A memory breakpoint invokes the debug monitor when a 
specified memory location is referenced. There are a total of 
four memory breakpoints available. 

ur num type [ addr ] 

Sets a memory breakpoint. Num must be to 3, addr is 
the breakpoint address, and type gives the type of 
memory access that will trigger the breakpoint. Valid 
types are: 

Execute 

10 Byte write 

1 1 Byte read/write 
20 Word write 

1 j 21 Word read/write 

40 Long write 

41 Long read/write 
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Note that the first digit specifies the breakpoint length 

and the second specifies the access type (write-only or 

read/write). The breakpoint is global unless the type is 

ORed with 100, which makes it local; or with 200, which /""N 

makes it global and local. For example, 140 specifies a > ~ y 

local long write-only breakpoint. 

ux num type [ addr ] 

Like ur, but sets a temporary (one-shot) breakpoint. 

uc num 

Clears a memory breakpoint. 

up Prints all memory breakpoints. 

Miscellaneous Commands 
bt [ addr ] 

Displays a stack backtrace, using addr as a frame pointer. 
The default address is the contents of %ebp. This works 
only with C language routines in protected mode. 

fi start end value 

Fills memory from address sfarf up to (but not including) ^ 

address end with the byte value. 

pg "string" [ args... ] 

Prints the string. Percent signs in the string are treated 
as in pr/nff(3S): %d, %u, %x, %o, %b, %s, %s, %c are 
supported. 

In addition, %y prints its argument in symbolic form, if possi- 
ble. 

re Reads any commands that have been loaded previously 
with the mkdbcmd (1M) command. 

rg [ addr ] 

Changes the pointer to the "register save area," from 
which all references to CPU registers, such as the dr com- 
mand, and explicit reference, such as %ebx, or an implicit 
reference, such as the di command with no argument, 
retrieve registers. Normally, the register save .area is set 
up automatically, but you can use a different set of regis- 
ters when you use rg to change the pointer. 

P9 [n] 

If n is 0, turns paging off. If n is 1, turns paging on. If n 
is missing, it simply reports whether paging is on or off. If 
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paging is off, the monitor interprets all addresses as phy- 
sical addresses. If paging is on, addresses are inter- 
preted as linear (virtual) addresses. (Breakpoints are 
always linear addresses.) 

ma addr 

Displays the page directory and page table entries used 
to map the given linear address to a physical address. 
This behaves the same whether paging is on or off. 

c3 addr 

Uses the given physical address as the base of the page 
directory for translating linear to physical addresses. This 
address is obtained from the special register CR3 if no c3 
command is given. 

pr addr 

Prints the value of the address given as an argument. 
This is most useful if addr is an expression (see the earlier 
discussion of arguments). 

ds addr 

Prints the value of the address as an offset from the 
nearest symbol. 

sy [ n ] [ max ] 

If n is 0, turns symbolic display off. If n is 1 , turns sym- 
bolic display on. If n is missing, it simply reports whether 
symbolic display is on or off. If max is given, it specifies 
the maximum offset for printing symbols. For example, if 
max is 1000, a symbol may be displayed in the form 
name+NNN, where NNN is 1 through 1000, but if NNN 
would be greater than 1000, the non-symbolic display for- 
mat is used. 

he or ?? 

Lists the monitor commands. 

ve Prints the version number of the monitor. 

Macro Commands 

dm "name" arg-count 

Defines a MACRO, with the given name and the specified 
number of arguments. The cm command (described 
below) can be used subsequently to invoke the macro. 
After you enter the dm command, the debugger prompts 
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with mac> for the body of the macro. Any debugger 
commands can be entered as the body of the macro, 
although interactive commands, such as di are not recom- 
mended. The expression $n, where n is a digit from 1 to 
9, is replaced on invocation with the nth argument to the 
macro. Entry of the macro body is terminated by a period 
(.) anywhere in the macro body. Include a period in the 
macro body by preceding the character with a backslash 
V. 

cm "name" args 

Calls a macro. The number of arguments must match the 
number given when the macro was defined. The effect is 
as if the body of the macro were entered in place of the 
cm command. 

em "name" 

Erases (deletes) the named macro. 

im ["name"] 

Lists the named macro. If the macro name is omitted, 
lists all macros. 

nx Repeats the call to the previously invoked macro. The 
arguments used ar the ones used on the previous call, 
possibly modified by any intervening sa commands. 

sa n value 

Sets the nth macro argument to the given value. The 
value of n should be between 1 and 9. Useful within a 
macro to set up the arguments for the next call through 
an nx commmand. 

ec [n] 

If n is 1, macros are echoed when they are invoked. If n 
is (the default), macros are not echoed. If n is missing, 
the status of the echo flag is printed. If the ec command 
is given within a macro body, it is in effect only for that 
macro. 

Conditional Commands 
IF expr EL FI 

If the expression evaluates to zero, all commands up to 
the matching EL or FI are skipped. If the expression is 
non-zero, execution proceeds normally to the matching 
FI, unless a matching EL is found, in which case, 
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commands between the EL and the FI are skipped. Dur- 
ing any of this "skipping," the prompt changes from K> 
to \mK> to indicate that the commands are being read 
but not executed. 

SEE ALSO 

cons(1M), Iddrv(lM), mkdbsym(IM) in the Administrator's 
Reference Manual. 

BUGS 

If you try to go at the exact address where a breakpoint is 
set, the breakpoint will not trigger. 

The disassembler works only with protected mode (32 bit) 
instructions. It does not know how to disassemble 16 bit 
instructions. 
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NAME 

mkdbsym - add symbols to kernel debugger 

SYNOPSIS 

mkdbsym [ -s ] [ -u ] [ -d ] [ symfile ] 

DESCRIPTION 

Mkdbsym allows the kernel debugger to use symbolic names 
in addition to numeric addresses. The symbols are taken from 
the named symfile, or /unix if symfile is not specified. 

There are three options to mkdbsym: 

-s By default, if the symbol file appears not to match the 
running kernel, mkdbsym prints an error message and 
exits. The -s flag overrides this check. 

-u Specifies an update: the symbols from symfile are 
appended to any symbols which are currently known to 
the debugger. This is useful, for example, in adding sym- 
bols for a newly loaded loadable driver [see Iddrv(lM)]. 

-d Causes the symbols in the symbol file to be deleted from 
the kernel debugger. If any symbol in the symbol file is 
not currently in the kernel debugger, a warning message 
is printed. 

FILES 

/etc/lddrv/unix.sym contains kernel symbols 

SEE ALSO 

Iddrv(lM). 

kdb(1) in the Programmer's Reference Manual. 
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NAME 

mkfs - construct a file system 

SYNOPSIS 

/etc/mkfs [ -y ] special [ -O ] [ blocks ] 
[ :i-nodes ] [ gap blocks/cyl ] 

/etc/mkfs [ -y ] special [ -O ] proto [ gap blocks/cyl ] 

DESCRIPTION 

Mkfs constructs a file system by writing on the special file 
using the values found in the remaining arguments of the 
command line. The command asks for confirmation before 
starting to construct the file system, unless the -y flag is given. 

If the second argument is a string of digits, the size of the file 
system is the value of blocks interpreted as a decimal number. 
This is the number of 1K byte disk blocks the file system will 
occupy. If the second argument is missing, the size of the file 
system is taken to be the size of the partition, determined by 
reading the volume home block of the disk [see /V(1)]. If the 
number of i-nodes is not given, the default is the number of 
logical (1024 byte) blocks divided by 4. Mkfs builds a file sys- 
tem with a single empty directory on it. The boot program 
block (block zero) is left uninitialized. 

The -O option makes a file system with a free list instead of a 
bit map 

If the second argument is the name of a file that can be 
opened, mkfs assumes it to be a prototype file proto, and will 
take its directions from that file. The prototype file contains 
tokens separated by spaces or new-lines. A sample prototype 
specification follows (line numbers have been added to aid in 
the explanation): 

1. /stand/ diskboot 

2. 4872 no 

3. d--777 3 1 

it. usrd--777 3 1 

5. sh ---755 3 1 /bin/sh 

6. :L rsh /bin/sh 

7. ken d--755 6 1 

8. $ 

9. bO b--6W 3 10 

10. cO c-- 641 3 1 
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11. s 

12. $ 

Line 1 in the example is the name of a file to be copied onto 
block zero as the bootstrap program. 

Line 2 specifies the number of 1 K byte blocks the file system 
is to occupy and the number of i-nodes in the file system. 

Lines 3-10 tell mkfs about files and directories to be included 
in this file system. 

Line 3 specifies the root directory. 

Line 6 tells mkfs to link rsh to /bin/sh. 

Lines 4-7 and 9-10 specify other directories and files. 

The $ on line 8 tells mkfs to end the branch of the file system 
it is on, and continue from the next higher directory. The $ on 
lines 11 and 12 end the process, since no additional specifica- 
tions follow. 

File specifications give the mode, the user ID, the group ID, 
and the initial contents of the file. Valid syntax for the con- 
tents field depends on the first character of the mode. 

The mode for a file is specified by a 6-character string. The 
first character specifies the type of the file. The character 
range is -bed to specify regular, block special, character spe- 
cial, and directory files respectively. The second character of 
the mode is either u or - to specify set-user-id mode or not. 
The third is g or - for the set-group-id mode. The rest of the 
mode is a 3 digit octal number giving the owner, group, and 
other read, write, execute permissions [see chmod(1)]. 

Two decimal number tokens come after the mode; they 
specify the user and group IDs of the owner of the file. 

If the file is a regular file, the next token of the specification 
may be a path name whence the contents and size are 
copied. If the file is a block or character special file, two 
decimal numbers follow which give the major and minor dev- 
ice numbers. If the file is a directory, mkfs makes the entries . 
and .. and then reads a list of names and (recursively) file 
specifications for the entries in the directory. As noted above, 
the scan is terminated with the token $. 
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The final argument in both forms of the command specifies 
the rotational gap and the number of blocks Icy I. 

If the gap and blockslcyl are not specified or are considered 
illegal values a default value of gap size 7 and 400 blocks/cyl 
is used. 

FILES 

/usr/lib/iv 

SEE ALSO 

chmod(1) in the User's Reference Manual. 

dir(4), fs(4) in the Programmer's Reference Manual. 

BUGS 

With a prototype file, it is not possible to copy in a file larger 
than 64K bytes. The maximum number of i-nodes configur- 
able is 65500. The :L syntax in the prototype file is not sup- 
ported in this release. 
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NAME 

mkifile - make an ifile from an object file 

SYNOPSIS 

mkifile a.out ifile 

DESCRIPTION 

Mkifile takes an object module and writes in ifile a line of the 
form 

symbol = Oxva/ue; 

for each external symbol in the object module. This (We can 
be used as an argument to /d(1) as an absolute symbol table 
against which other modules may be linked. Mkifile is used 
with loadable drivers to provide the symbols for the currently 
running System V. 

For example, 

mkifile /unix /etc/lddrv/unix.sym 
will produce the unix/sym file needed by Iddrv. 

SEE ALSO 

ld(1), Iddrv(lM). 
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NAME 

mklost + found - make a lost + found directory for fsck 

SYNOPSIS 

/etc/mklost + found 

DESCRIPTION 

A directory lost + found is created in the current directory and 
a number of empty files are created therein and then removed 
so that there will be empty slots for f$ck{M). This command 
should be run immediately after first mounting a newly 
created file system. 

SEE ALSO 

fsck(1M),mkfs(1M) 

BUGS 

Should be done automatically by mkfs . 
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NAME 

mknod - build special file 

SYNOPSIS 

/etc/mknod name b | c major minor 

/etc/mknod name p 

DESCRIPTION 

Mknod makes a directory entry and corresponding i-node for 
a special file. 

The first argument is the name of the entry. The 6000/50 Sys- 
tem convention is to keep such files in the /dev directory. 

In the first case, the second argument is b if the special file is 
block-type (disks, tape) or c if it is character-type (other dev- 
ices). The last two arguments are numbers specifying the 
major device type and the minor device (for example, unit, 
drive, or line number). They may be either decimal or octal. 
The assignment of major device numbers is specific to each 
system. The information is contained in the system source file 
conf.c. You must be the super-user to use this form of the 
command. 

The second case is the form of the mknod that is used to 
create fifo's (also called named pipes). 

WARNING 

If mknod is used to create a device in a remote directory 
(Remote File Sharing), the major and minor device numbers 
are interpreted by the server. 

SEE ALSO 

mknod (2) in the Programmer's Reference Manual. 
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NAME 

mount, umount - mount and unmount file systems and remote 
resources 

f" SYNOPSIS 

/etc/mount [ [ -r ] [ -f fstyp ] special directory ] 

/etc/mount [ [ -r ] [ -d ] resource directory ] 

/etc/umount special 

/etc/umount [ -d ] resource 

DESCRIPTION 

File systems other than root (/) are considered removable in 
the sense that they can be either available to users or unavail- 
able. Mount announces to the system that special, a block 
special device, or resource, a remote resource, is available to 
users from the mount point directory. Directory must exist 
already; it becomes the name of the root of the newly 
mounted special. 

Mount, when entered with arguments, adds an entry to the 

.<— N table of mounted devices, /etc/mnttab. Umount removes the 

{^J entry. If invoked with no arguments, mount prints the entire 

mount table. If invoked with an incomplete argument list, 

mount searches /etc/fstab for the missing arguments. 

The following options are available: 

-r Indicates that special or resource is to be mounted 

read-only. If special or resource is write-protected, 
this flag must be used. 

-d Indicates that resource is a remote resource that is 

to be mounted on directory or unmounted. To 
mount a remote resource, Remote File Sharing 
must be up and running and the resource must be 
advertised by a remote computer [see rf start (1M) 
and aoV (1M)j. If -d is not used, special must be a 
local block special device. 
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-f fstyp Indicates that fstyp is the file system type to be 
mounted. If this argument is omitted, it defaults to 
the root fstyp. 

special Indicates the block special device that is to be 
mounted on directory. 

resource indicates the remote resource name that is to be 
mounted on a directory. 

directory indicates the directory mount point for special or 
resource. (The directory must already exist.) 

Umount announces to the system that the file system previ- 
ously mounted special or resource is to be made unavailable. 
If invoked with an incomplete argument list, umount searches 
/etc/fstab for the missing arguments. 

Mount can be used by any user to list mounted file systems 
and resources. Only a super-user can mount and unmount 
file systems. 

FILES 

/etc/mnttab mount table 
/etc/fstab file system table 

SEE ALSO 

adv(1M), fuser(1M), rfstart(IM), setmnt(lM), unadv(1M). 
mount(2), umount(2), fstab(4), mnttab(4) in the Programmer's 
Reference Manual. 

DIAGNOSTICS 

If the mount {2) system call fails, mount prints an appropriate 
diagnostic, mount issues a warning if the file system to be 
mounted is currently mounted under another name. A remote 
resource mount will fail if the resource is not available or if 
Remote File Sharing is not running. 

Umount fails if special or resource is not mounted or if it is 
busy. Special or resource is busy if it contains an open file or 
some user's working directory. In such a case, you can use 
fuser (1M) to list and kill processes that are using special or 
resource. 

WARNINGS 

Physically removing a mounted file system diskette from the 
diskette drive before issuing the umount command damages 
the file system. 
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NAME 

mountall, umountall - mount, unmount multiple file systems 

SYNOPSIS 
'\ /etc/mountall [ - ] [ file-system-table ] ... 

/etc/umountall [ -k ] 

DESCRIPTION 

These commands may be executed only by the super-user. 

Mountall is used to mount file systems according to a file- 
system-table, (/etc/fstab is the default file system table.) The 
special file name "-" reads from the standard input. 

Before each file system is mounted, it is checked using 
/ssfaf(1M) to see if it appears mountable. If the file system 
does not appear mountable, it is checked, using fsck (1M), 
before the mount is attempted. 

Umountall causes all mounted file systems except root to be 
unmounted. The -k option sends a SIGKILL signal, via 
fuser (1M), to processes that have files open. 

( ) The file-system-table has the following format: 

column 1 block special file name of file system 

column 2 mount-point directory 

column 3 -r if to be mounted read-only; -d if remote 

column 4 (optional) file system type string 

column 5+ ignored 

White-space separates columns. Lines beginning with "#" are 
comments. Empty lines are ignored. 

A typical file-system-table might read: 

/dev/dsk/c1d1s3 /usr -r S51K 

SEE ALSO 

fsck(1M), fsstat(1M), fuser(1M), mount(lM). 
^_ signal (2), f stab (4) in the Programmer's Reference Manual. 

KJ DIAGNOSTICS 

No messages are printed if the file systems are mountable 
and clean. 
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Error and warning messages come from fsdc(1M), fesfaf(1M), 
and mount (1M). 
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NAME 

mvdir - move a directory 

r ^ SYNOPSIS 

v_/ /etc/mvdir dirname name 

DESCRIPTION 

Mvdir moves directories within a file system. Dirname must be 
a directory. If name does not exist, it will be created as a 
directory. If name does exist, dirname will be created as 
name/dirname. Dirname and name may not be on the same 
path; that is, one may not be subordinate to the other. For 
example: 

mvdir x/y x/z 
is legal, but 

mvdir x/y x/y/z 
is not. 

SEE ALSO 

/""^ mkdir(1), mv(1) in the User's Reference Manual. 



WARNINGS 

Only the super-user can use mvdir. 
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NAME 

ncheck - generate path names from i-numbers 

SYNOPSIS 

/etc/ncheck [ -i i-numbers ] [ -a ] [ -s ] [ file-system ] 

DESCRIPTION 

Ncheck with no arguments generates a path-name versus i- 
number list of all files on a set of default file systems (see 
/etc/checklist). Names of directory files are followed by /.. 

The options are as follows: 

-i Limits the report to only those files whose i-numbers fol- 
low. 

-a Allows printing of the names . and .., which are ordinarily 
suppressed. 

-s Limits the report to special files and files with set-user-ID 
mode. This option may be used to detect violations of 
security policy. 

A file system may be specified by its special file. 

The report should be sorted so that it is more useful. 

SEE ALSO 

fsck(1M). 

sort(1) in the User's Reference Manual. 

DIAGNOSTICS 

If the file system structure is not consistent, ?? denotes the 
"parent" of a parentless file and a path-name beginning with 
. . . denotes a loop. 
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NAME 

newgrp - log in to a new group 

SYNOPSIS 

newgrp [ - ] [ group ] 

DESCRIPTION 

Newgrp changes a user's group identification. The user 
remains logged in and the current directory is unchanged, but 
calculations of access permissions to files are performed with 
respect to the new real and effective group IDs. The user is 
always given a new shell, replacing the current shell, by 
newgrp, regardless of whether it terminated successfully or 
due to an error condition (that is to say, unknown group). 

Exported variables retain their values after invoking newgrp; 
however, all unexported variables are either reset to their 
default value or set to null. System variables (such as PS1, 
PS2, PATH, MAIL, and HOME), unless exported by the sys- 
tem or explicitly exported by the user, are reset to default 
values. For example, a user has a primary prompt string 
(PS1) other than $ (default) and has not exported PS1. After 
an invocation of newgrp, successful or not, their PS1 will now 
be set to the default prompt string $. Note that the shell com- 
mand export [see s/)(1)] is the method to export variables so 
that they retain their assigned value when invoking new shells. 

With no arguments, newgrp changes the group identification 
back to the group specified in the user's password file entry. 
This is a way to exit the effect of an earlier newgrp command. 

If the first argument to newgrp is a -, the environment is 
changed to what would be expected if the user actually 
logged in again as a member of the new group. 

A password is demanded if the group has a password and the 
user does not, or if the group has a password and the user is 
not listed in /etc/group as being a member of that group. 
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FILES 

/etc/group system's group file 

/etc/passwd system's password file 

SEE ALSO 

csh(1), login(1), sh(1). 

group(4), passwd(4), environ(5) in the Programmer's Refer- 
ence Manual. 

BUGS 

There is no convenient way to enter a password into 
/etc/group. Use of group passwords is not encouraged, 
because, by their very nature, they encourage poor security 
practices. Group passwords may disappear in the future. 
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NAME 

nlsadmin - network listener service administration 

,^ SYNOPSIS 

^_J nlsadmin -x 

nlsadmin [ options ] net_spec 

DESCRIPTION 

Nlsadmin administers the network listener process(es) on a 
machine. Each network has a separate instance of the net- 
work listener process associated with it; each instance (and 
thus, each network) is configured separately. The listener pro- 
cess "listens" to the network for service requests, accepts 
requests when they arrive, and spawns servers in response to 
those service requests. The network listener process will work 
with any network (more precisely, with any transport provider) 
that conforms to the transport provider specification. 

The listener supports two classes of service: a General 
Listener Service that starts server daemons with connections 
for clients on remote machines, and a Terminal Login Service 
/^ that starts a geffy(1M) process for login clients on remote 

% -- ■*' machines. The Terminal Login Service requires special associ- 

ated software, and is only available with some networks. 
Currently, it is supported on the AT&T STARLAN and the 
DARPA Internet networks. 

The following may be given as option parameters or argu- 
ments to nlsadmin: 

netjspec The relative pathname under /dev of the network 
special device (that is to say, the STREAMS driver) 
to open for access to a given network. 

Note that the example below, and other Internet- 
specific examples and files that follow, would 
operate as described only if optional Internet 
drivers and utilities were installed on the 6000/50 
system. 
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For example, inet/tcp refers to the Transmission 
Control Protocol (fcp) transport provider within the 
DARPA Internet (/nef) protocol family. 

service Uniquely identifies the service the listener is manag- 
ing. It may be expressed symbolically as a name 
or numerically as a code. If a name is given, it is 
looked up in the file /usr/net/nls/servcodes [see 
sen/codes (4)] and converted into a code. 

address The transport address on which the listener awaits 
requests for service. Since they await disjointed 
sets of services, the General Listener Service and 
the Terminal Login Service require separate listener 
network addresses, network addresses are inter- 
preted using a syntax that allows for a variety of 
addressing formats [see reso/vers(5)]. For exam- 
ple, the two listener addresses on host spcfast 
serving a DARPA Internet network could be 
expressed symbolically as: 

\ : inet : nlsgen : spefast . Convergent . COM 

\ : inet : nlsterm : spefast . Convergent . COM 

The "\:" sequence determines the syntax of the 
remainder of the address, symbolic in this case. 
The transport provider is in the inet protocol and 
addressing family. Thus, the inet program in direc- 
tory /usr/net/resolvers is executed with the com- 
plete address as an argument in order to fully 
resolve the symbolic network address. It converts 
either nlsgen or nlsterm via the /etc/services into 
the service "port" and then converts 
spcfast.Convergent.COM via /etc/hosts into the 
network "host" address. A fully resolved network 
address suitable for an Internet transport provider 
is returned via the standard output. 

Each unique network (that is to say, netjspec) must have a 
dedicated listener process. When the network is first con- 
nected, nlsadmin with the -i option must be used to initialize 
the listener's database, the -I and -t options used to set the 
listener's addresses, and the -a option used to explicitly add 
supported services. Once the networks on a new machine 
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have been set up, they do not need to be set up again. If a 
unique new network (that is to say, netjspec) is connected, 
then these steps should be repeated. 

Once the network is set up, nlsadmin can be used to query 
the status of all or particular listener networks and services, 
start or kill the listener process per network, temporarily 
enable or disable a service per network, or permanently add 
or remove a service per network. Changing the list of services 
provided by the listener produces immediate changes, while 
changing an address on which the listener listens has no 
effect until the listener is restarted. 

The following combinations of options can be used. 

nlsadmin Gives a brief usage message. 

nlsadmin -x 

Reports the status of all of the listener processes 
installed on this machine. 

nlsadmin netjspec 

Prints the status of the listener process for 
netjspec. 

nlsadmin -q netjspec 

Queries the status of the listener process for the 
specified network, and reflects the result of that 
query in its exit code. If a listener process is active, 
nlsadmin exits with a status of 0; if no process is 
active, the exit code is 1; while the exit code is 
greater than 1 in case of error. 

nlsadmin -v netjspec 

Prints a verbose report on the servers associated 
with netjspec, giving the service code, status, com- 
mand, and comment for each. 

nlsadmin -z service netjspec 

Prints a report on the server associated with 
netjspec that has service name or code service, 
giving the same information as in the -v option. 

nlsadmin -q -z service netjspec 

Queries the status of the service with service name 
or code service on network netjspec, and exits 
with a status of if that service is enabled, 1 if that 
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service is disabled, and greater than 1 in case of 
error. 

nlsadmin -I address netjspec 

Changes or sets the address on which the General 
Listener Service listens for network netjspec. This 
is the address generally used by remote processes 
to access the servers available through this listener 
(see the -a option, below). 

A change of address will not take effect until the 
next time the listener for that network is started. 
Since all listeners on a common network must be 
reachable by remote clients at a commonly agreed 
address, care should be exercised when changing 
the listener address. For the Internet networks, this 
"known" address is built from the service "port" in 
the shared /etc/services file. 

If address is just a dash ("-"), nlsadmin reports the 
address currently configured, instead of changing 
it. 

nlsadmin -t address netjspec 

Changes or sets the address on which the Terminal 
Login Service listens for network netjspec. A ter- 
minal service address should not be defined unless 
the appropriate remote login software is available. 
Otherwise, this option is identical to the -I option. 






Page 4 UP-13529 



NLSADMIN(IM) 



O 



o 



nlsadmin -i netjspec 

Initializes or changes a listener process for the net- 
work specified by netjspec; that is, it creates and 
initializes the files required by the listener. Note 
that the listener should only be initialized once for a 
given network, and that doing so does not actually 
invoke the listener for that network. The listener 
must be initialized before assigning addressing or 
services. 

nlsadmin [-m] -a service [-c command] [-p modules] 

[-y comment] netjspec 

Adds a new service to the list of services available 
through the General Listener Service for network 
netjspec. When a service is added, it is automati- 
cally enabled (see the -e and -d options, below). If 
the -m option is specified, the entry is added but 
not emabled; it is marked as an administrative 
entry. 

The command is the full pathname of the command 
with all arguments that are to be invoked in 
response to the service request. Since it must 
appear as a single word to the shell, it should be 
quoted if arguments are given. If the -c option is 
not given, then the service is looked up in 
/usr/net/nls/servcodes where the command and 
arguments must be found. 

If the -p option is specified, then modules is inter- 
preted as a list of STREAMS modules for the 
listener to push before starting the added service. 
The modules are pushed in the order they are 
specified. The module list is specific to the network 
(netjspec) supporting the service. 

The optional comment is a brief (free-form) descrip- 
tion of the service for use in various reports. If the 
comment contains white space, it must be quoted. 
If the comment is not specified, then the service is 
looked up in /usr/net/nls/servcodes where the 
default comment may be found. 

nlsadmin -r service netjspec 

Removes the entry for the service from that 
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listener's list of services. This is normally per- 
formed only in conjunction with the de-installation 
of a service from a machine, 

nlsadmin -e service netjspec 

nlsadmln -d service netjspec 

Enables or disables (respectively) the service indi- 
cated by service for the specified network 
netjspec. The service must have previously been 
added to the listener for that network (see the -a 
option, above). Disabling a service causes subse- 
quent service requests for that service to be 
denied, but the processes from any prior service 
requests that are still running will continue unaf- 
fected. 

nlsadmin -s netjspec 

nlsadmin -k netjspec 

Start and kill (respectively) the listener process for 
the indicated network netjspec. These operations 
are normally performed as part of the system 
startup and shutdown procedures. Before a 
listener can be started for a particular network, it 
must first have been initialized, and an address 
must be defined for the General Listener Service 
(see the -i and -I options, above). When a listener 
is killed, processes that are still running as a result 
of prior service requests will continue unaffected. 

The listener runs under its own ID of listen, with group ID 
adm. This ID must be entered in the system password file 
/etc/passwd; the HOME directory listed for that ID is con- 
catenated with netjspec to determine the location of the 
listener configuration information for each network. 

Nlsadmin may be invoked by any user to generate reports, 
but all operations that affect a listener's status or configura- 
tion are restricted to the super-user. 

FILES 

/usr/net/nls/servcodes 
/usr/net/nls/nef_spec 

SEE ALSO 

getty(1M). 
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servcodes(4), rfmaster(4), resolvers(5) in the Programmer's 

Reference Manual. 

System V Operating System Network Programmer's Guide. 
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NAME 

nmlmaint - loadable driver name list maintenance 

SYNOPSIS 



C /etc/lddrv/nmlmaint -a driver 



/etc/lddrv/nmlmaint -d driver 
/etc/lddrv/nmlmaint -D 

DESCRIPTION 

This program is used to update the loadable driver name list in 
/etc/lddrv/unix.sym. It is usually run automatically at system 
initialization time to purge the symbol file of stale information 
so that it can be updated with the symbols of current loadable 
drivers. 

Nmlmaint has three options: 

-a Adds the symbols in the file /etc/lddrv/oV/Ver to the list in 
/etc/lddrv/unix.sym. 

-d Causes the symbols associated with the driver to be 
deleted from /etc/lddrv/unix.sym. 

-D Causes symbols associated with all loadable drivers to be 
deleted, leaving only the symbols associated with /unix 
itself. 

Nmlmaint is used by the Iddrv^M) command to maintain the 
loadable driver name list in /etc/lddrv/unix.sym. 

FILES 

/etc/lddrv/unix.sym 
/etc/lddrv/dr/Ver 

SEE ALSO 

Iddrv(lM), mkifile(IM). 
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NAME 

nsquery - Remote File Sharing name server query 

SYNOPSIS 

nsquery [ -h ] [ name ] 

DESCRIPTION 

Nsquery provides information about resources available to the 
host from both the local domain and from other domains. All 
resources are reported, regardless of whether the host is 
authorized to access them. When used with no options, 
nsquery identifies all resources in the domain that have been 
advertised as sharable. A report on selected resources can be 
obtained by specifying name, where name is: 

nodename The report will include only those 

resources available from nodename. 

domain. The report will include only those 

resources available from domain. 

domain. nodename The report will include only those 
resources available from 

domain.nodename . 

When the name does not include the delimiter ".", it will be 
interpreted as a nodename within the local domain. If the 
name ends with a delimiter ".", it will be interpreted as a 
domain name. 

The information contained in the report on each resource 
includes its advertised name (domain.resource), the read/write 
permissions, the server (nodename.domain) tr>at advertised 
the resource, and a brief textual description. 

When -h is used, the header is not printed. 

A remote domain must be listed in your rfmaster file in order 
to query that domain. 

EXIT STATUS 

If no entries are found when nsquery is executed, the report 
header is printed. 



If your host cannot contact the domain name server, an error 
message will be sent to standard error. 
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SEE ALSO 

adv(1M), unadv(lM). 

rfmaster(4) in the Programmer's Reference Manual. 
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NAME 

profiler: prfld, prfstat, prfdc, prfsnap, prfpr • 6000/50 system 
profiler 

SYNOPSIS 

/etc/prfld [ system_namelists ... ] 

/etc/prfstat on 

/etc/prfstat off 

/etc/prfdc file [ period [ offjiour ] ] 

/etc/prfsnap file 

/etc/prfpr file [ cutoff [ system_namelists ... ] ] 

DESCRIPTION 

Prfld, prfstat, prfdc, prfsnap, and prfpr form a system of pro- 
grams to facilitate an activity study of the System V operating 
system. A kernel configured with kernel profiling must be 
used. 

Prfld is used to initialize the recording mechanism in the sys- 
tem. It generates a table containing the starting address of 
each system subroutine as extracted from system _namelist 
files. If no name lists are given, /unix is used. More than one 
name list may be given; for example, if loadable drivers are 
present in the system, /unix as well as several loadable driver 
name lists in /etc/lddrv may be given. 

Prfstat is used to enable or disable the sampling mechanism. 
Profiler overhead is less than 1% as calculated for 500 text 
addresses. Prfstat will also reveal the number of text 
addresses being measured. 

Prfdc and prfsnap perform the data collection function of the 
profiler by copying the current value of all the text address 
counters to a file where the data can be analyzed. Prfdc will 
store the counters into file every period minutes and will turn 
off at offjiour (valid values for offjiour are 0-24). Prfsnap 
collects data at the time of invocation only, appending the 
counter values to file. 

Prfpr formats the data collected by prfdc or prfsnap. Each 
text address is converted to the nearest text symbol (as found 
in system jiamelist) and is printed if the percent activity for 
that range is greater than cutoff. 
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FILES 

/dev/prf interface to profile data and text addresses 

/unix default for system namelist file 
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NAME 

pwck, grpck - password/group file checkers 

SYNOPSIS 



O; /etc/pwck [ file ] 



/etc/grpck [ file ] 

DESCRIPTION 

Pwdc scans the password file and notes any inconsistencies. 
The checks include validation of the number of fields, login 
name, user ID, group ID, and whether the login directory and 
the program-to-use-as-Shell exist. The default password file is 
/etc/passwd. 

Grpck verifies all entries in the group file. This verification 
includes a check of the number of fields, group name, group 
ID, and whether all login names appear in the password file. 
The default group file is /etc/group. 

FILES 

/etc/group 
/etc/passwd 

SEE ALSO 

group(4), passwd(4) in the Programmer's Reference Manual. 

DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 
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NAME 

qinstall - install and verify software using the mkfs(1M) proto 
file database 

( ) SYNOPSIS 

/usr/local/bin/qinstall -c [ -esolm ] proto root 

/usr/local/bin/qinstall -g [ -p prefix ] [ -t # ] root 

/usr/local/bin/qinstall -r [ -q ] proto root fromjfile 
to_rfile 

DESCRIPTION 

Qinstall is used to package software on distribution media, to 
install software, and to verify the correctness of the installa- 
tion. Output from qinstall goes to standard output. Roof 
must be a full pathname or ".". 

The following options are recognized by qinstall: 

-V Output additional, verbose messages to stderr. 

•c Check whether files under root match files in profo for 
s-^ owner and permission. This option is used primarily to ver- 

< ^_) ify the correctness of an installation, but it is also used in 

the software distribution packaging process. 

-o Print omissions from roof. 

;■ -s Set permissions and owners to be correct if incorrect. 

-e Print extra files not found in . proto 

-i Ignore differences in special files. 

-m Check mounted file systems as well. 

-g Generate a proto file from root. This option is used in the 
software distribution packaging process. 

-p Add specified prefix to path names. 

-t Specify number of tabs to indent. 

-r Replace file tojfile in roof with contents of fromjfile, 

,_~ % keeping permissions as in proto. Tojfile path must be a 

(^ j full path name as in the proto file, and will be offset with 

root. Multiple from/to pairs may be specified. This option 

is used to install customizable software. 

-q Query before replace. Options are to replace tojfile 
with fromjfile, to save fromjfile, to ignore tojfile, to 
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perform an sd/ff(1) between the two files or to 
replace tojfile with the previous diff. 

EXAMPLE 

A sample proto file created with the -g option follows, (qin- 
stall -g . > . ./proto) 



/mkboot 


install 

IsamRel 
$ 



usr 



include 

iserc.h 
Isam.h 

$ 

lib 



d- 



isam 
IsamConfig -- 
IsamCreate -- 
IsamProtect -- 
IsamReorg -- 
IsamStat 
IsamStop 
IsamTransfer 
IxFilter 
IxSpec ---755 
isam 
$ 

libisam.a 

$ 
$ 



d--777 2 2 
d--775 
144 /install/IsamRel 

d--775 2 2 
d--775 2 2 
---444 2 2 /usr/ include/ iserc.h 

— 444 2 2 /usr/include/isam.h 

d--775 2 2 
-775 2 2 

-755 2 2 /usr/Hb/ isam/ IsamConfig 
-755 2 2 /usr/lib/ isam/ IsamCreate 
-755 2 2 /usr/Hb/ isam/ IsamProtect 
-755 2 2 /usr/lib/isam/lsamReorg 

---755 2 2 /usr/lib/ isam/ IsamStat 

— 755 2 2 /usr/lib/isam/lsamStop 
---755 2 2 /usr/1 Jb/isam/isamTransfer 

-755 2 2 /usr/lib/ isam/ IxFilter 
2 2 /usr/1 ib/ isam/ IxSpec 
•755 2 2 /usr/lib/ isam/ isam 



---444 2 2 /usr/lib/libisam.a 



SEE ALSO 

qlist(1M), ctinstall(IM), mkfs(1M). 

BUGS 

Qinstall invoked with the -m option on an inconsistent file sys- 
tem produces error messages of the form "filename: cannot 
stat". 
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NAME 

qlist - print out file lists from proto file; set links based on lines 
in proto file. 

SYNOPSIS 

/usr/local/bin/qlist -m [ -d dir ] [ -o ] [ -p prefix ] proto 

/usr/local/bin/qlist -I dir [ -p prefix ] proto 

/usr/local/bin/qlist -s proto root 

DESCRIPTION 

Qlist is used in the distribution software packaging process 
and in the software installation process. It makes lists of files 
from proto files created by q/nsfa//(1M). Lists are based on 
the files' group identifiers and types. Qlist also sets links 
based on lines in the proto file during software installation. 

Qlist understands extended proto files, in which a line begin- 
ning with :L indicates that the first file named is a link to the 
second file. Other lines beginning with : are comments. The 
last field on a line in an extended proto file is a group identifier 
of 9 or fewer characters, such as "WP" for the Word Proces- 
sor product. The following symbols appearing immediately 
after the group identifier designate the file's type and have the 
following meanings: 

+ designates a customizable file, such as /etc/passwd. This 
type of file is one which the user may or may not want to 
install over the existing version. This type of file can be 
installed with the -rq option of qinst all (1M). 

designates a zero-length file. The specified file should not 
be used when updating an existing system; rather, it 
should be used for raw, or first installs only. 

@ implies an update but no query from qinstall (1M). This 
symbol is used for files required by the installation tools 
for installation and for possible text busy files. 

< designates an optional file, or a file requiring special instal- 
lation such as a hardware configuration-dependent file. 
Its associated special installation scripts are GROUP.opt 
and GROUP .ins, where GROUP represents the group 
name. 
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< id 

designates a file of the above category which has special 
installation scripts named GROUPid.opX, GROUPidAns, 
where GROUP represents the group name. Id can be 5 or 
fewer characters. The total number of characters in % - 

GROUP and id must be 10 or fewer. 

The following options are recognized by qlist : 

-V Output additional, verbose messages to stderr. 

■m Make file lists from proto file. This option is used in pack- 
aging software. 

-o Print files in no group. 

-d Use dir as location for file lists. 

-p Use prefix when printing (default = ./). 

For example, file lists output with the -m option for group 
"WP" are named as follows: 

■s- WP.cust 





WP.noup 


@ 


WP.noqu 


< 


WP.fopt, WP.flst 


< id 


WP.fopt, WPid.lst 



the rest WP 

-I List files in directory dir from proto file to stdout, 

•p Use prefix when printing (default = ./). 

-s Set Sinks in root directory which are indicated by :L lines 
in proto file. Root must be a rooted path name or ".". This 
option is used in software instailations. 

EXAMPLE 

A sample extended proto file foliows. Note that the files Docu- 
ment and Gloss are really links to the file Admin, as indicated 
by :L at the beginning of these fines. Also note that the lines 
ending in < designate optionally installed, or specially 
installed files. 



O 
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/mkboot 













1 










d-- 


777 2 2 










install 


d- 


-775 








WPRel 
$ 


-- 


■W /install/WPRel 


WP 




oa 


d- 


-775 








.Key 


d- 


-755 








Admin 


-- 


-Ml 2 2 /oa/. Key /Admin 




UNIX 


:L 


Document 




/oa/. Key/Admin 




UNIX 


:L 


Gloss 
$ 
.Document 




/oa/. Key /Admin 




UNIX 




d- 


-775 








Recruit 
$ 


-- 


-666 2 2 /oa/. Document/Recruit 


WP 




.Gloss 


d- 


- 775 








Sample 

$ 

Centronix 


-- 


-666 2 2 /oa/.Gloss/Sample 




WP 




-- 


-555 2 2 /oa/Centronix 


WP< 


sys 




tmagenDriver-- 


-555 2 2 /oa/lmagenDriver 


WP< 


sys 




SerialDriver-- 


-555 2 2 /oa/Serial Driver 


WP< 


sys 




abs_rel 


-- 


-555 2 2 /oa/abs_rel 


WP< 


propt 




ctospool 


-- 


-555 2 2 /oa/ctospool 


WP 






def_wp 


-- 


-555 2 2 /oa/def_wp 


WP< 


propt 




spool stat 


-- 


-555 2 2 /oa/spoolstat 


WP 






wp_def 


-- 


-555 2 2 /oa/wp_def 


WP< 


propt 




wp_edit 


-- 


-555 2 2 /oa/wp_edit 


WP 






wpjnerge 


-- 


-555 2 2 /oa/wp_merge 


WP 






wp_print 


-- 


-555 2 2 /oa/wp_print 


WP 






wp_review 


-- 


-555 2 2 /oa/wp_review 


WP 






wpp_band 


-- 


-555 2 2 /oa/wpp_band 


WP< 


propt 




wpp_canprt 


-- 


-555 2 2 /oa/v*pp_canprt 


WP 






wpp_diablo 


-- 


-555 2 2 /oa/wpp_diablo 


WP< 


propt 




wpp_imagen 


-- 


-555 2 2 /oa/wpp_imagen 


WP< 


propt 




wpp_laser 


-- 


-555 2 2 /oa/wpp_laser 


WP< 


propt 




wpp_necspir 


i -- 


-555 2 2 /oa/wpp_necspin 


WP< 


propt 




wpp_prtsh 
$ 


~ - 


-555 2 2 /oa/wpp_prtsh 


WP 





SEE ALSO 

qinstall(IM), ctinstall(IM). 



UP-13529 



Page 3 



QLIST(IM) 

[This page left blank.] 



Page 4 UP-13529 



(' 



f ) 



RCO(IM) 



NAME 

rcO - run commands performed to stop the operating system 

SYNOPSIS 
/etc/rcO 

DESCRIPTION 

This file is executed at each system state change that needs 
to have the system in an inactive state. It is responsible for 
those actions that bring the system to a quiescent state, tradi- 
tionally called "shutdown". 

There are three system states that require this procedure. 
They are state 4 (the system halt state), state 5 (the reboot 
state), and state 6 (the administration state). Whenever a 
change to one of these states occurs, the letc/rcO procedure 
is run. The entry in /etc/inittab might read: 

sO:01456:waft:/etc/rcO < /dev/console > /dev/console 2>&1 

Some of the actions performed by letc/rcO are carried out by 
files beginning with K or S in /etc/rcO.d. These files are exe- 
cuted in ASCII order (see FILES below for more information), 
terminating some system services. 

The recommended sequence for /etc/rcO is: 

Stop System Services and Daemons. 

• Various system services (such as the LP Spooler) are 
gracefully terminated. 

• When new services are added that should be terminated 
when the system is shut down, the appropriate files are 
installed in /etc/rcO.d. 

Terminate Processes 

• SIGTERM signals are sent to all running processes by 
W//a//(1M). Processes stop themselves cleanly if sent 
SIGTERM. 

Kill Processes 

• SIGKILL signals are sent to all remaining processes; no 
process can resist SIGKILL. 

• At this point the only processes left are those associated 
with (etc/rcO and processes and 1 , which are special to 
the operating system. 
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Unmount All File Systems 

• Only the root file system (/) remains mounted. 

Depending on which system state the system ends up in (4, 5, 
or 6), the entries in /etc/inittab will direct what happens next. 
If the /etc/inittab has not defined any other actions to be per- 
formed as in the case of system state 0, then the operating 
system will have nothing to do. It should not be possible to 
get the system's attention. The only thing that can be done is 
to turn off the power or possibly get the attention of a 
firmware monitor. 

This command can be used only by the super-user. 

FILES 

The execution by /bin/sh of any files in /etc/rcO.d occurs in 
ASCII sort-sequence order. See rc2(1M) for more information. 

SEE ALSO 

killall(IM), rc2(1M), shutdown(IM). 
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NAME 

rc2 - run commands performed for multi-user environment 

SYNOPSIS 
/etc/rc2 

DESCRIPTION 

This file is executed via an entry in /etc/inittab and is respon- 
sible for those initializations that bring the system to a ready- 
to-use state, traditionally state 2, called the "multi-user" state. 

The actions performed by /etc/rc2 files beginning with S and 
K in /etc/rc2.d. These files are executed by /bin/sh in ASCII 
sort-sequence order (see FILES for more information). When 
functions are added that need to be initialized when the sys- 
tem goes multi-user, an appropriate file should be added in 
/etc/rc2.d. 

The functions done by /etc/rc2 command and associated 
/etc/rc2.d files include: 

• Setting the uucp node name and the NETWORK host 
name according to /etc/fstab. 

• Mounting file systems according to /etc/fstab. 

• Cleaning up (remaking) the /tmp and /usr/tmp directories. 

• Loading the network interface and ports cards (if any) 
with program data and starting the associated processes. 

• Starting the cron daemon by executing /etc/cron. 

• Cleaning up (deleting) uucp locks status, and temporary 
files in the /usr/spool/uucp directory. 

Other functions can be added, as required, to support the 
addition of hardware and software features. 

EXAMPLES 

The following are prototypical files found in /etc/rc2.d. These 
files are prefixed by an S or K and a number indicating the 
execution order of the files. 
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MOUNTFILESYS 

# Set up and mount file systems 

cd / f ' 

/etc/mountal 1 /etc/fstab 'V- 

RHTHPFILES 

H clean up /tmp 
rm -rf /tmp 
mkdir /tmp 
chmod 777 /tmp 
chgrp sys /tmp 
chown sys /tmp 

uucp 

# clean-up uucp locks, status, and temporary files 

rm -rf /usr/spool /locks/* 

The file /etc/TIMEZONE is included early in Jetc/rc2, thus 
establishing the default time zone for all commands that fol- 
low. jfr ^ 

FILES (j 

Here are some hints about files in /etc/rc2.d: 

The order in which files are executed is important. Since they 
are executed in ASCII sort-sequence order, using the first 
character of the file name as a sequence indicator will help 
keep the proper order. Thus, files starting with the following 
characters would be: 

[0-9]. very early 

[A-ZJ. early 

[a-n]. later 

[o-zj. last 

Files in /etc/rc2.d must begin with an S or a K followed by a 

number and the rest of the file name. Upon entering run level 

2, files beginning with S are executed with the start option; 

files beginning with K, are executed with the stop option. ^ 

Files beginning with other characters are ignored. ( 

SEE ALSO 

shutdown (1M). 
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NAME 

reboot - reboot the system 

SYNOPSIS 
/etc/reboot 

DESCRIPTION 

Reboot issues a uadmin{2) call to ask the system to wait for 
the disks to become quiescent and then to reboot the system. 
The reboot procedure is identical to power-on reset except 
that the system will not try to take a crash dump. 

Only super-user is allowed to execute reboot. 

WARNINGS 

This command is provided for compatibility. Uadmin (1M) 
should be used instead of reboot. 
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NAME 

renice - alter priority of running process by changing nice 

SYNOPSIS 

/usr/local/bin/renice pid [ priority ] 

DESCRIPTION 

Renice can be used by the super-user to alter the priority of a 
running process. By default, the nice value of the process is 
made '19', which means that it will run only when nothing else 
in the system wants to. This can be used to nail long-running 
processes that are interfering with interactive work. 

Renice can be given a second argument to choose a nice 
value other than the default. Negative nice values can be 
used to make things go very fast. 

FILES 

/unix 
/dev/kmem 

SEE ALSO 

nice(1). 

BUGS 

If you make the nice value very negative, then the process 
cannot be interrupted. To regain control you must put the 
nice value back (for example, to 0). 
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NAME 

rfadmin - Remote File Sharing domain administration 

SYNOPSIS 
rfadmin 

rfadmin -a hostname 

rfadmin -r hostname 

rfadmin -p 

DESCRIPTION 

Rfadmin is used to add and remove hosts and their associated 
authentication information from a ctoma/n/passwd file on a 
Remote File Sharing primary domain name server. It is also 
used to transfer domain name server responsibilities from one 
machine to another. Used with no options, rfadmin returns 
the hostname of the current domain name server for the local 
domain. 

Rfadmin can only be used to modify domain files on the pri- 
mary domain name server (-a and -r options). If domain 
name server reponsibilities are temporarily passed to a secon- 
dary domain name server, that computer can use the -p 
option to pass domain name server responsibility back to the 
primary. Any host can use rfadmin with no options to print 
information about the domain. The user must have root per- 
missions to use the command. 

-a hostname Used to add a host to a domain that is 
served by this domain name server. Host- 
name must be of the form 
domain. nodename . It creates an entry for 
hostname in the c/oma/n/passwd file, which 
has the same format as /etc/passwd, and 
prompts for an initial authentication pass- 
word; the password prompting process con- 
forms with that of passwdft). 

•r hostname Used to remove a host from its domain by 
removing it from the domain /pa sswd file. 

-p Used to pass the domain name server 

responsibilities back to a primary or to a 
secondary name server. 
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ERRORS 

When used with the -a option, if hostname is not unique in the 
domain, an error message is sent to the standard error. 

When used with the -r option, if (1) hostname does not exist in 
the domain, (2) hostname is defined as a domain name server, 
an error message will be sent to standard error. 

When used with the -p option to change the domain name 
server, if there are no backup name servers defined for 
domain, an error message will be sent to standard error. 

FILES 

/usr/nserve/auth.info/doma/n/passwd 

For each domain, this file is created on the primary, 
should be copied to all secondaries, and should be copied 
to all hosts that want to do password verification of hosts 
in the domain.) 

SEE ALSO 

rfstart(lM), rfstop(1M). 
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NAME 

rfpasswd - change Remote File Sharing host password 

SYNOPSIS 
K..J rfpasswd 

DESCRIPTION 

Rfpasswd updates the Remote . File Sharing authentication 
password for a host; processing of the new password follows 
the same criteria as passwd(l). The updated password is 
registered at the domain name server 
(/usr/nserve/auth.info/c/o/na/n/passwd) and replaces the 
password stored at the local host (/usr/nserve/loc.passwd 
file). 

This command is restricted to the super-user. 

Note: If you change your host password, make sure that 
hosts that validate your password are notified of this change. 
To receive the new password, hosts must obtain a copy of the 
dbma/n/passwd file from the domain's primary name server. 
If this is not done, attempts to mount remote resources may 
fail! 

ERRORS 

If (1) the old password entered from this command does not 
match the existing password for this machine, (2) the two new 
passwords entered from this command do not match, (3) the 
new password does not satisfy the security criteria in 
passwd(\), (4) the domain name server does not know about 
this machine, or (5) the command is not run with super-user 
privileges, an error message will be sent to standard error. 
Also, Remote File Sharing must be running on your host and 
your domain's primary name server. A new password cannot 
be logged if a secondary is acting as the domain name server. 

FILES 

/usr/nserve/auth.info/doma/n/passwd 
/usr/nserve/loc.passwd 

SEE ALSO 

rfstart(lM), rfadmin(IM). 
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NAME 

rfstart - start Remote File Sharing 

SYNOPSIS 

rfstart [ -v ] [ -p primaryjaddr ] 

DESCRIPTION 

Rfstart starts Remote File Sharing and defines an authentica- 
tion level for incoming requests. (This command can only be 
used after the domain name server is set up and your 
computer's domain name and network specification has been 
defined using dname (1M).) 

•v Specifies that verification of all clients is required in 
response to initial incoming mount requests; any host not 
in the file /usr/nserve/auth.info/cfoma/n/passwd for the 
domain they belong to, will not be allowed to mount 
resources from your host. If -v is not specified, hosts 
named in domain /passwd will be verified; other hosts will 
be allowed to connect without verification. 

-p primary _addr 

Indicates the primary domain name server for your 
domain. Primary_addr must be the network address of 
the primary name server for your domain. If the -p option 
is not specified, the address of the domain name server is 
taken from the rf master file. (See rfmaster (1M) for a 
description of the valid address syntax.) 

If the host password has not been set, rfstart will prompt for a 
password; the password prompting process must match the 
password entered for your machine at the primary domain 
name server [see rradm/n (1M)]. If you remove the 
loc. passwd file or change domains, you will also have to 
reenter the password. 

Also, when rfstart is run on a domain name server, entries in 
the rfmaster (4) file are syntactically validated. 

This command is restricted to the super-user. 

ERRORS 

If syntax errors are found in validating the rfmaster (4) file, a 
warning describing each error will be sent to standard error. 

If (1) the shared resource environment is already running, (2) 
there is no communications network, (3) the domain name 
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server cannot be found, (4) the domain name server does not 
recognize the machine, or (5) the command is run without 
super-user privileges, an error message will be sent to stan- 
dard error. 

Remote file sharing will not start if the host password in 
/usr/nserve/loc.passwd is corrupted. If you suspect this has 
happened, remove the file and run rfstart again to reenter 
your password. 

Note: rfstart will NOT fail if your host password does not 
match the password on the domain name server. You will 
simply receive a warning message. However, if you try to 
mount a resource from the primary or any other host that vali- 
dates your password, the mount will fail if your password does 
not match the one that host has listed for your machine. 

FILES 

/usr/nserve/rfmaster 
/usr/nserve/loc. passwd 

SEE ALSO 

adv(1M), dname(lM), mount(lM), rfadmin(lM), rfstop(1M), 

unadv(1M). 

rfmaster(4) in the Programmer's Reference Manual, 
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NAME 

rfstop - stop the Remote File Sharing environment 

f\ t SYNOPSIS 

v_- ; rfstop 

DESCRIPTION 

Rfstop disconnects a host from the Remote File Sharing 
environment until another rfsf a/? (1M) is executed. 

When executed on the domain name server, the domain name 
server responsibility is moved to a secondary name server as 
designated in the rfmaster file. 

This command is restricted to the super-user. 

ERRORS 

If (1) there are resources currently advertised by this host, (2) 
resources from this machine are still remotely mounted by 
other hosts, (3) there are still remotely mounted resources in 
the local file system tree, (4) /fsfart(1M) had not previously 
been executed, or (5) the command is not run with super-user 
f"\ privileges, an error message will be sent to standard error. 

SEE ALSO 

adv(1M), mount(1M), rf admin (1M), rfstart(IM), unadv(1M). 
rfmaster(4) in the Programmer's Reference Manual. 
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NAME 

rfuadmin - Remote File Sharing notification shell script 

f") SYNOPSIS 

v_y rfuadmin message remote_resource [ seconds ] 

DESCRIPTION 

The rfuadmin administrative shell script responds to unex- 
pected Remote File Sharing events, such as broken network 
connections and forced unmounts, picked up by the rfudae- 
mon process. This command is not intended to be run 
directly from the shell. 

The response to messages received by rfudaemon can be 
tailored to suit the particular system by editing the rfuadmin 
script. The following paragraphs describe the arguments 
passed to rfuadmin and the responses. 

disconnect remotejesource 

A link to a remote resource has been cut. Rfudaemon 
executes rfuadmin, passing it the message disconnect 
/— % and the name of the disconnected resource. Rfuadmin 

\^J sends this message to all terminals using wa//(1): 

Remotejesource has been disconnected from the sys- 
tem. 

Then it executes fuser(1M) to kill all processes using the 
resource, unmounts the resource [umount (1M)] to clean 
up the kernel, and starts rmount to try to remount the 
resource. 

fumount remofe_resource 

A remote server machine has forced an unmount of a 
resource a local machine has mounted. The processing is 
similar to processing for a disconnect. 

fuwarn remotejesource seconds 

This message notifies rfuadmin that a resource is about to 
be unmounted. Rfudaemon sends this script the fuwarn 
message, the resource name, and the number of seconds 
in which the forced unmount will occur. Rfuadmin sends 
this message to all terminals: 

Remotejesource is being removed from the system in # 
seconds. 
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SEE ALSO 

fumount(lM), rmount(1M), rfudaemon(IM), rfstart(IM). 
wall(1) in the User's Reference Manual. 

BUGS 

The console must be on when Remote File Sharing is running. 
If not, rfuadmin will hang when it tries to write to the console 
(wall) and recovery from disconected resources will not com- 
plete. 
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NAME 

rfudaemon - Remote File Sharing daemon process 

SYNOPSIS 
rfudaemon 

DESCRIPTION 

The rfudaemon command is started automatically by 
rfstart (1M) and runs as a daemon process as long as Remote 
File Sharing is active. Its function is to listen for unexpected 
events, such as broken network connections and forced 
unmounts, and execute appropriate administrative procedures. 

When such an event occurs, rfudaemon executes the adminis- 
trative shell script rfuadmin, with arguments that identify the 
evert. This command is not intended to be run from the shell. 
Here are the events: 

DISCONNECT 

A link to a remote resource has been cut. Rfudaemon 
executes rfuadmin, with two arguments: disconnect and 
the name of the disconnected resource. 

FUMOUNT 

A remote server machine has forced an unmount of a 
resource a local machine has mounted. Rfudaemon exe- 
cutes rfuadmin, with two arguments: fumount and the 
name of the disconnected resource. 

GETUMSG 

A remote user-level program has sent a message to the 
local rfudaemon. Currently the only message sent is 
fuwarn, which notifies rfuadmin that a resource is about to 
be unmounted. It sends rfuadmin the fuwarn, the 
resource name, and the number of seconds in which the 
forced unmount will occur. 

LASTUMSG 

The local machine wants to stop the rfudaemon 
[rfstop (1M)]. This causes rfudaemon to exit. 

SEE ALSO 

rfstart(IM), rfuadmin(IM). 
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NAME 

rmntstat - display mounted resource information 

SYNOPSIS 

rmntstat [ -h ] [ resource ] 

DESCRIPTION 

When used with no options, rmntstat displays a list of all local 
Remote File Sharing resources that are remotely mounted, the 
local path name, and the corresponding clients. Rmntstat 
returns the remote mount data regardless of whether a 
resource is currently advertised; this ensures that resources 
that have been unadvertised but are still remotely mounted 
are included in the report. When a resource is specified, 
rmntstat displays the remote mount information only for that 
resource. The -h option causes header information to be 
omitted from the display. 

EXIT STATUS 

If no local resources are remotely mounted, rmntstat will return 
a successful exit status. 

ERRORS 

If resource (1) does not physically reside on the local machine 
or (2) is an invalid resource name, an error message will be 
sent to standard error. 



SEE ALSO 

mount(1M), fumount(IM), unadv(1M). 



UP-13529 Page 1 



RMNTSTAT(IM) 



[This page left blank.] 



I ; 






Page 2 UP-13529 



RMOUNT(IM) 



NAME 

rmount - retry remote resource mounts 

f * ) SYNOPSIS 

% — J /etc/rmount -d [ r ] special directory 

DESCRIPTION 

Rmount is an administrative shell script that tries to mount 
remote resource special on directory. If the remote mount is 
unsuccessful, rmount will wait 60 seconds and try to mount 
the resource again. This will repeat forever. The RETRIES = 
value in the shell script can be changed to limit the number of 
times the shell script will try to mount a remote resource. The 
wait time (TIME =60) can also be changed. 

See mount (1M) for a description of the options. 

FILES 

/etc/mnttab mount table 

SEE ALSO 

^ fumount(IM), fuser(1M), mount(lM), rfstart(lM), 

( -^ rfuadmin(IM), setmnt(1M). 

'w' mnttab(4) in the Programmer's Reference Manual. 
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NAME 

rmountall, rumountall - mount, unmount Remote File Sharing 
resources 

SYNOPSIS 

/etc/rmountall [ - ] file-system-table [ ... ] 

/etc/rumountall [ -k ] 

DESCRIPTION 

Rmountall is a Remote File Sharing command used to mount 
remote resources according to a file-system-table (/etc/fstab 
is the recommended file-system-table.) The special file name 
"-" reads from the standard input. 

Rumountall causes all mounted remote resources to be 
. unmounted. The -k option sends a SIGKILL signal, via 
fuser (1M), to processes that have files open. 

These commands may be executed only by the super-user. 

The file-system-table format is as follows: 

Column 1 Block special file name of file system. 

v "' Column 2 Mount- point directory. 

Column 3 -r if to be mounted read-only; 
•d if remote resource. 

Column 4 File system type (not used with Remote File 
Sharing). 

Column 5 + Ignored. 

White-space separates columns. Lines beginning with "#" are 
comments. Empty lines are ignored. 

SEE ALSO 

fuser(1M), mount(1M), rfstart(IM), 

signal (2) in the Programmer's Reference Manual. 

DIAGNOSTICS 

No messages are printed if the remote resources are mounted 
/"""•, successfully. 

Error and warning messages come from mount (1M). 



v. 
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NAME 

runacct - run daily accounting 

r SYNOPSIS 

v- -■ /usr/lib/acct/runacct [ mmdd [ state ] ] 

DESCRIPTION 

Runacct is the main daily accounting shell procedure. It is 
normally initiated via cron (1M). Runacct processes connect, 
fee, disk, and process accounting files. It also prepares sum- 
mary files for prdaily or billing purposes. Disk block counts 
are reported for 512-byte blocks. 

Runacct takes care not to damage active accounting files or 
summary files in the event of errors. It records its progress 
by writing descriptive diagnostic messages into active. When 
an error is detected, a message is written to /dev/console, 
mail [see mail(\)] is sent to root and adm, and runacct ter- 
minates. Runacct uses a series of lock files to protect against 
re-invocation. The files lock and lockl are used to prevent 
simultaneous invocation, and lastdate is used to prevent more 
f 1 than one invocation per day. 

Runacct breaks its processing into separate, restartable states 
using statefile to remember the last state completed. It 
accomplishes this by writing the state name into statefile. 
Runacct then looks in statefile to see what it has done and to 
determine what to process next. States are executed in the 
following order: 

SETUP Move active accounting files into working files. 

WTMPFIX Verify integrity of wtmp file, correcting date 
changes if necessary. 

CONNECT1 Produce connect session records in ctmp.h 
format. 

CONNECT2 Convert ctmp.h records into tacct.h format. 

PROCESS Convert process accounting records into 
f~\ tacct.h format. 

*" / MERGE Merge the connect and process accounting 

records. 
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FEES Convert output of chargefee into tacct.h for- 

mat and merge with connect and process 
accounting records. 

DISK Merge disk accounting records with connect, 

process, and fee accounting records. 

MERGETACCT 

Merge the daily total accounting records in 
daytacct with the summary total accounting 
records in /usr/adm/acct/sum/tacct. 

CMS Produce command summaries. 

USEREXIT Any installation-dependent accounting pro- 
grams can be included here. 

CLEANUP Cleanup temporary files and exit. 

To restart runacct after a failure, first check the active file for 
diagnostics, then fix up any corrupted data files such as pacct 
or wtmp. The lock files and lastdate file must be removed 
before runacct can be restarted. The argument mmdd is 
necessary if runacct is being restarted, and specifies the 
month and day for which runacct will rerun the accounting. 
Entry point for processing is based on the contents of sta- 
tefile; to override this, include the desired sfafe on the com- 
mand line to designate where processing should begin. 

EXAMPLES 

To start runacct: 

nohup runacct 2> /usr/adm/acct/nite/fd21og & 
To restart runacct: 

nohup runacct 0601 2» /usr/adm/acct/nite/fd21og & 
To restart runacct at a specific state: 
nohup runacct 0601 MERGE 2» /usr/adm/acct/nite/fd21og & 
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FILES 

/etc/wtmp 

/usr/adm/pacct* 

/usr/src/cmd/acct/tacct.h 

/usr/src/cmd/acct/ctmp.h 

/usr/adm/acct/nite/active 

/usr/adm/acct/nite/daytacct 

/usr/adm/acct/nite/lock 

/usr/adm/acct/nite/lock1 

/usr/adm/acct/nite/lastdate 

/usr/adm/acct/nite/statefile 

/usr/adm/acct/nite/ptacct*.mmdd 

SEE ALSO 

acct(1M), acctcms(IM), acctcon(lM), acctmerg(IM), 

acctprc(lM), acctsh(1M), cron(1M). 

acctcom(1), mail(1) in the User's Reference Manual. 

acct(2), acct(4), utmp(4) in the Programmer's Reference 

Manual. 

BUGS 

Normally it is not a good idea to restart runacct in the SETUP 
state. Run SETUP manually and restart via: 

runacct mmdd WTMPFIX 

If runacct failed in the PROCESS state, remove the last ptacct 
file because it will not be complete. 
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NAME 

sadp - disk access profiler 

SYNOPSIS 

sadp [ -th ] [ -d device [ -drive ] ] s [ n ] 

DESCRIPTION 

Sadp reports disk access location and seek distance, in tabu- 
lar or histogram form. It samples disk activity once every 
second during an interval of s seconds. This is done repeat- 
edly if n is specified. Cylinder usage and disk distance are 
recorded in units of 8 cylinders. 

The valid value of device is disk. Drive specifies the disk 
drives and it may be: 

• a drive number in the range supported by device, 

• two numbers separated by a minus (indicating an 
inclusive range), or 

• a list of drive numbers separated by commas. 

Up to 8 disk drives may be reported. The -d option may be 
omitted, if only one device is present. 

The -t flag causes the data to be reported in tabular form. 
The -h flag produces a histogram on the printer of the data. 
Default is -t. 

EXAMPLE 

The command: 

sadp -d disk-0 900 4 

will generate 4 tabular reports, each describing cylinder usage 
and seek distance of disk drive during a 15-minute interval. 

FILES 

/dev/kmem 

SEE ALSO 

mem (7). 
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NAME 

sar: sal, sa2, sadc - system activity report package 

^ SYNOPSIS 

Q J /usr/Hb/sa/sadc [ t n ] [ ofile ] 

/usr/lib/sa/sa1 [ t n ] 

/usr/lib/sa/sa2 [ -ubdycwaqvmprSDAC ] [ -s time ] 
[ -e time ] [ -i sec ] 

DESCRIPTION 

System activity data can be accessed at the special request of 
a user [see sar(1)] and automatically on a routine basis as 
described here. The operating system contains a number of 
counters that are incremented as various system actions 
occur. These include counters for CPU utilization, buffer 
usage, disk and tape I/O activity, TTY device activity, switching 
and system-call activity, file-access, queue activity, inter- 
process communications, paging and Remote File Sharing. 

Sadc and shell procedures, sal and sa2, are used to sample, 
^ % save, and process this data. 

\~s Sadc, the data collector, samples system data n times every f 

seconds and writes in binary format to ofile or to standard 
output. If f and n are omitted, a special record is written. This 
facility is used at system boot time, when booting to a mul- 
tiuser state, to mark the time at which the counters restart 
from zero. For example, the /etc/init.d/perf file writes the res- 
tart mark to the daily data by the command entry: 

su sys -c "/usr/l ib/sa/sadc /usr/adm/sa/sa~date +%d % " 

The shell script sal, a variant of sadc, is used to collect and 
store data in binary file /usr/adm/sa/sadd where dd is the 
current day. The arguments t and n cause records to be writ- 
ten n times at an interval of f seconds, or once if omitted. The 
entries in /usr/spool/cron/crontabs/sys [see cron(1M)]: 

0***0-6 /usr/l ib/sa/sal 
/"- \ 20,10 8-17 * * 1-5 /usr/l ib/sa/sal 
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will produce records every 20 minutes during working hours 
and hourly otherwise. 

The shell script sa2, a variant of sar(1), writes a daily report in 
file /usr/adm/sa/sardd. The options are explained in sar(1), 
The /usr/spool/cron/crontabs/sys entry: 

5 18 * * 1-5 /usr/lib/sa/s'a2 -s 8:00 -e 18:01 -i 3600 -A 

will report important activities hourly during the working day. 

The structure of the binary daily data file is: 



struct sa j 

struct sysinfo si; 
struct minfo mi; 
struck dinfo di; 



/* see /usr/include/sys/sysinfo.h */ 
/* defined in sys/sysinfo.h */ 
/* RFS info defined in */ 

/* sys/sysinfo.h */ 
int minserve, maxserve; /* RFS server low and high */ 

/* water marks */ 
int szinode; /* current size of i-node table */ 
int szfile; /* current size of file table */ 
int szproc; /* current size of proc table */ 
int szlckf; /* current size of file record */ 

/* header table */ 
int szlckr; /* current size of file record */ 
/* lock table */ 
/* size of i-node table */ 
/* size of file table */ 
/* size of proc table */ 
/* maximum size of file record */ 
/* header table */ 
/* maximum size of file record */ 
/* lock table */ 

/* cumulative overflows of i-node */ 
/* table */ 

/* cumulative overflows of file */ 
/* table */ 

/* cumulative overflows of proc */ 
/* table */ 
time_t ts; /* time stamp, seconds */ 
long devio[NDEVS][4]; /* device unit information */ 
#define 10_0PS /* cumulative 1/0 requests */ 

#define 10_BCNT 1 /* cumulative blocks */ 



int 


mszinode; 


int 


mszfile; 


int 


mszproc; 


int 


mszlckf; 


int 


mszlckr; 


long 


inodeovf; 


long 


fileovf; 


long 


procovf; 
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/* transferred */ 


#define IO_ACT 


2 /* cumulative drive busy */ 




/* time in ticks */ 


^define 10_RESP 


3 /* cumulative I/O resp */ 


I; 


f time in ticks */ 


* 9 

FILES 




/usr/adm/sa/sacW 


daily data file 


/usr/adm/sa/sarcW 


daily report file 


/tmp/sa.adrfl 


address file 


SEE ALSO 




cron(1M). 





sag(lG), sar(1), timex(1) in the User's Reference Manual. 
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NAME 

scpioctl - download code to active SCP boards. 

SYNOPSIS 



( ) 

\^y /etc/scpioctl file 



I ) 



DESCRIPTION 

Scpioctl opens the special file /dev/scp and uses the SCPAT- 
TACH ioctl command to download the specified code file to all 
active SCP boards. 

The file /etc/scpmon.out contains the download code 
expected. If the scp driver is loaded at boot time, the rc2 
script automatically invokes the following command: 

scpioctl /etc/scpmon.out 

Note that if the scp driver is loaded manually and the 
/etc/master file specifies active SCP boards, the command 
shown above must be issued before the active SCP boards 
are operational. 

FILES 

/etc/scpmon.out 

SEE ALSO 

SCp(7). 

DIAGNOSTICS 

Scpioctl silently fails if it is unable to open /dev/scp, which 
happens if the scp driver is not loaded or if there are no active 
SCP boards in the system. Any other errors produce self- 
explanatory messages. 
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NAME 

scsicnfg - configure devices on the SCSI bus 

r~\ SYNOPSIS 

v_V scsicnfg [ -deu ] [ -s specfile ] 

DESCRIPTION 

Scsicnfg is used to examine and set up configuration parame- 
ters for devices attached to the SCSI bus. Normally, it is 
called by the startup file, /etc/inittab. 

The following options are available: 

-d Displays the SCSI bus configurations currently in 

effect. 

-e Examines the file specified by -s specfile and 

prints any invalid lines with a diagnostic message. 
If no -s specfile is given, /etc/scsiconfig is exam- 
ined. 

-u Configure the SCSI bus using the configuration 

file given by -s specfile. If any entry in the 

f~~} specfile is invalid, or the drive to be remapped is 

^-* / busy or non-existent, an error message is 

returned and no configuration is done. 

-s specfile Specify the configuration file specfile to be used 
by the -e or -u option. 

The specfile contains the following required information: 

scsibusno Number of SCSI busses installed in the system. 

targetid SCSI target ID number for the device. 

lun SCSI logical unit number for the device. 

The following SCSI options can be included; see scs/(7) for 
more information: 

parity Enable parity on the SCSI bus. 

reselect Enable the disconnect-reconnect feature for the 
target device. 

sync Use synchronous protocol instead of the default 

asynchronous protocol. When the -u option is 
specified, scsicnfg attempts to communicate with 
the target in sync mode; if communications fail, 
configuration stops at the failing entry in the 
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specfile. 
Lines in the file beginning with # are treated as comments. 

EXAMPLES 

The following specfile sets up the parameters for two SCSI 
disk drives: 

/dev/rdsk/cOdl scsibusno=0 targetfd=3 lun=0 parity reselect 
/dev/rdsk/cOd2 scsibusno=0 target ids'! lun=0 parity reselect 

The following example configures a SCSI QIC device: 

/dev/rmtO scsibusno=0 target id=1 lun=0 parity reselect 

/dev/rmtl scsibusno=0 targetid=5 lun=0 parity reselect 

The following example configures a SCSI tape device: 

/dev/rmt/cldO scsibusno=0 target id=6 lun=0 parity reselect 

FILES 

/etc/scsisystem default configuration file 

SEE ALSO 

scsi(7). 
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NAME 

setmnt • establish mount table 

SYNOPSIS 
/ete/setmnt 

DESCRIPTION 

Setmnt creates the /etc/mnttab table [see mnttab (4)] which is 
needed for both the mount (1M) and umount commands. 
Setmnt reads standard input and creates a mnttab entry for 
each line. Input lines have the format: 

filesys node 

where filesys is the name of the file system's special file (for 
example, /dev/dsk/e?d?s?) and node is the root name of 
that file system. Thus filesys and node become the first two 
strings in the mount table entry. 

FILES 

/etc/mnttab 

SEE ALSO 

devnm(lM), mount(1M). 

mnttab (4) in the Programmer's Reference Manual. 

BUGS 

Problems may occur if filesys or node is longer than 32 char- 
acters. 

Setmnt silently enforces an upper limit on the maximum 
number of mnttab entries. 
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NAME 

shutdown, halt - shut down system, change system state 

SYNOPSIS 

/etc/shutdown [ -y ] [ -m message ] [ -g grace_period ] 
[ -i init_state ] 

DESCRIPTION 

This command is executed by the super-user to change the 
state of the machine. By default, it brings the system to a 
state where only the console has access to the 6000/50 sys- 
tem. This state is traditionally called "single-user." 

The command sends a warning message and a final message 
before it starts actual shutdown activities. By default, the 
command asks for confirmation before it starts shutting down 
daemons and killing processes. The options are used as fol- 
lows: 

-y Pre-answers the confirmation question so the command 
can be run without user intervention. A default of 60 
seconds is allowed between the warning message and the 
final message. Another 60 seconds is allowed between 



, w the final message and the confirmation. 

-mmessage 

Specifies a message to be sent to each user before the 
system is shut down. 

-qgrace_period 

Allows the super-user to change the number of seconds 
from the 60-second default. 

•linitjstate 

Specifies the state in which ;*n/f(1M) is to be put following 
the warnings, if any. By default, system state "s" is used 
(the same as states "1" and "S"). 

Other recommended system state definitions are: 

state 

Shut the machine down so it is safe to remove the power. 
Have the machine remove power if it can. The /etc/rcO 
procedure is called to do this work. 

state 1 , s, S 

Bring the machine to the state traditionally called single- 
user. The letclrcO procedure is called to do this work. 
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(Though s and 1 are both used to go to single user state, 
s only kills processes spawned by inlt and does not 
unmount file systems. State 1 unmounts everything 
except root and kills all user processes, except those that 
relate to the console.) 

state 5 

Bring the machine to administration mode. 

state 6 

Stop the 6000/50 system and reboot to the state defined 
by the initdefault entry in /etc/inittab. 

SEE ALSO 

init(1M), rc0(1M), rc2(1M). 

inittab(4) in the Programmer's Reference Manual. 
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NAME 

strace - print STREAMS trace messages 

/- SYNOPSIS 

v J strace [ mid sid level ] ... 

DESCRIPTION 

Strace without arguments writes all STREAMS event trace 
messages from all drivers and modules to its standard output. 
These messages are obtained from the STREAMS log driver 
[log (7)]. If arguments are provided they must be in triplets of 
the form mid, sid, level, where mid is a STREAMS module ID 
number, sid is a sub-ID number, and level is a tracing priority 
level. Each triplet indicates that tracing messages are to be 
received from the given module/driver, sub-ID (usually indicat- 
ing minor device), and priority level equal to or less than the 
given level. The token all may be used for any member to 
indicate no restriction for that attribute. 

The format of each trace message output is: 

<seq> <time> < ticks > < level > < flags > <mid> <sid> 

{ ' ) <text> 

< seq > Trace sequence number. 

< time > Time of message in htv.mnxss. 

< ticks > Time of message in machine ticks since boot. 

< level > Tracing priority level. 

< flags > E : message is also in the error log. 

F : indicates a fatal error. 
N : mail was sent to the system administra- 
tor. 

< mid > Module ID number of source. 
<sid> Sub-ID number of source. 

< text > Formatted text of the trace message. 

Once initiated, strace will continue to execute until terminated 
f~~") by the user. 

EXAMPLES 

Output all trace messages from the module or driver whose 
module ID is 41: 
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strace 41 all all 

Output those trace messages from driver/module ID 41 with 
sub-IDs 0, 1 , or 2: 

strace 11 1 41 1 1 412 

Messages from sub-IDs and 1 must have a tracing level less 
than or equal to 1 . Those from sub-ID 2 must have a tracing 
level of 0. 

CAVEATS 

Due to performance considerations, only one strace process is 
permitted to open the STREAMS log driver at a time. The log 
driver has a list of the triplets specified in the command invo- 
cation, and compares each potential trace message against 
this list to decide if it should be formatted and sent up to the 
strace process. Hence, long lists of triplets will have a greater 
impact on overall STREAMS performance. Running strace will 
have the most impact on the timing of the modules and 
drivers generating the trace messages that are sent to the 
strace process. If trace messages are generated faster than 
the strace process can handle them, then some of the mes- 
sages will be lost. This last case can be determined by exa- 
mining the sequence numbers on the trace messages output. 

SEE ALSO 

l°9(7). 

System V Operating System STREAMS Programmer's Guide. 
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NAME 

strclean - STREAMS error logger cleanup program 

^ SYNOPSIS 

k^J strclean [ -d logdir ] [ -a age ] 

DESCRIPTION 

Strclean is used to clean up the STREAMS error logger direc- 
tory on a regular basis [for example, by using cron (1M)]. By 
default, all files with names matching error.* in 
/usr/adm/streams that have not been modified in the last 3 
days are removed. A directory other than /usr/adm/streams 
can be specified using the -d option. The maximum age in 
days for a log file can be changed using the -a option. 

EXAMPLE 

strclean -d /usr/adm/streams -8 3 

has the same result as running strclean with no arguments. 

NOTES 

Strclean is typically run from cron(1M) on a daily or weekly 
<f*-\ basis. 

W FILES 

/usr/adm/streams/error.* 

SEE ALSO 

cron(lM), strerr(1M). 

System V Operating System STREAMS Programmer's Guide. 
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NAME 

strerr - STREAMS error logger daemon 

SYNOPSIS 
strerr 

DESCRIPTION 

Strerr receives error log messages from the STREAMS log 
driver [log (7)] and appends them to a log file. The error log 
files produced reside in the directory /usr/adm/streams, and 
are named error.mm-dd, where mm is the month and dd is 
the day of the messages contained in each log file. 

The format of an error log message is: 

<seq> <time> < ticks > < flags > <mid> <sid> <text> 

< seq > Error sequence number. 
<time> Time of message in hh:mm:ss. 

< ticks > Time of message in machine ticks since boot 

priority level. 

< flags > T : the message was also sent to a tracing 

process. 

F : indicates a fatal error. 

N : send mail to the system administrator. 

< mid > Module ID number of source. 

< sid > Sub-ID number of source. 

< text > Formatted text of the error message. 

Messages that appear in the error log are intended to report 
exceptional conditions that require the attention of the system 
administrator. Those messages which indicate the total failure 
of a STREAMS driver or module should have the F flag set. 
Those messages requiring the immediate attention of the 
administrator will have the N flag set, which causes the error 
logger to send the message to the system administrator via 
ma//(1). 

The priority level usually has no meaning in the error log but 
will have meaning if the message is also sent to a tracer pro- 
cess. 
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Once initiated, strerr will continue to execute until terminated 
by the user. Commonly, strerr would be executed asynchro- 
nously. 

CAVEATS 

Only one strerr process at a time is permitted to open the 
STREAMS log driver. 

If a module or driver is generating a large number of error 
messages, running the error logger will cause a degradation in 
STREAMS performance. If a large burst of messages is gen- 
erated in a short time, the log driver may not be able to 
deliver some of the messages. This situation is indicated by 
gaps in the sequence numbering of the messages in the log 
files. 

FILES 

/usr/adm/streams/error.m/rj-o'd 

SEE ALSO 

log(7). 

System V Operating System STREAMS Programmer's Guide. 
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NAME 

su - become super-user or another user 

^ SYNOPSIS 

V_ J su I - 1 I name [ arg ... ] ] 

DESCRIPTION 

Su allows one to become another user without logging off. 
The default user name is root (that is to say, super-user). 

To use su, the appropriate password must be supplied (unless 
one is already root). If the password is correct, su will exe- 
cute a new shell with the real and effective user ID set to that 
of the specified user. The new shell will be the optional pro- 
gram named in the shell field of the specified user's password 
file entry [see passwd(4)], or /bin/sh if none is specified [see 
sh(1)]. To restore normal user ID privileges, type an EOF 
{cntrl-d) to the new shell. 

Any additional arguments given on the command line are 
passed to the program invoked as the shell. When using pro- 
grams like sh(1), an arg of the form -c string executes string 
f ) via the shell and an arg of -r will give the user a restricted 

*~ / shell. When additional arguments are passed, /bin/sh is 

always used. When no additional arguments are passed, su 
uses the shell specified in the password file. 

The following statements are true only if the optional program 
named in the shell field of the specified user's password file 
entry is like sh(1). If the first argument to su is a -, the 
environment will be changed to what would be expected if the 
user actually logged in as the specified user. This is done by 
invoking the program used as the shell with an argO value 
whose first character is -, thus causing first the system's pro- 
file (/etc/profile) and then the specified user's profile (.profile 
in the new HOME directory) to be executed. Otherwise, the 
environment is passed along with the possible exception of 
$PATH, which is set to /bln:/etc:/usr/bin for root. Note that if 
the optional program used as the shell is /bin/sh, the user's 
/ \ .profile can check argO for -sh or -su to determine if it was 

\,J invoked by login (1) or su(1), respectively. If the user's pro- 

gram is other than /bin/sh, then .profile is invoked with an 
argO of -program by both tog/n(1) and su(1). 
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All attempts to become another user using su are logged in 
the log file /usr/adm/sulog. 

EXAMPLES 

To become user bin while retaining your previously exported 
environment, execute: 

su bin 

To become user bin but change the environment to what 
would be expected if bin had originally logged in, execute: 

su - bfn 

To execute command with the temporary environment and 
permissions of user bin, type: 

su - bin -c "command args" 

FILES 

/etc/passwd system's password file 

/etc/profile system's profile 

$HOME/.profile user's profile 

/usr/adm/sulog log file 

SEE ALSO 

env(1), login(l), sh(1) in the User's Reference Manual. 
passwd(4), profile(4), environ(5) in the Programmer's Refer- 
ence Manual. 
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NAME 

swap - swap administrative interface 

^ SYNOPSIS 

_j /etc/swap -a swapdev [ swaplow [ swaplen ] ] 

/etc/swap -d swapdev [ swaplow ] 
/etc/swap -I 

DESCRIPTION 

Swap provides a method of adding, deleting, and monitoring 
the system swap areas used by the memory manager. The 
following options are recognized: 

-a Add the specified swap area. Swapdev is the name of the 
block special device, for example, /dev/dsk/c0d0s2. 
Swaplow is the offset in 512-byte blocks into the device 
where the swap area should begin. Swaplen is the length 
of the swap area in 512-byte blocks. If swaplen is miss- 
ing, the remainder of the partition (from swaplow to the 
end of the partition) is assumed. If both swaplow and 
^ % swaplen are missing, the entire partition is assumed (that 

is, swaplow is assumed to be block 0). This option can 
only be used by the super-user. 

-d Delete the specified swap area. Swapdev is the name of 
block special device, for example, /dev/dsk/c0d0s2. 
Swaplow is the offset in 512-byte blocks into the device 
where the swap area should begin. If swaplow is missing, 
it is assumed to be block 0. Using this option marks the 
swap area as "INDEL" (in process of being deleted). The 
system will not allocate any new blocks from the area, 
and will try to free swap blocks from it. The area will 
remain in use until all blocks from it are freed. This option 
can only be used by the super-user. 

-I List the status of all the swap areas. The output has four 
columns: 
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DEV 

The swapdev special file for the swap area if one can 
be found in the /dev/dsk or /dev directories, and its 
major/minor device number in decimal. 

LOW 

The swaplow value for the area in 512-byte blocks. 

LEN 

The swaplen value for the area in 512-byte blocks. 

FREE 

The number of free 512-byte blocks in the area. If 
the swap area is being deleted, this column will be 
marked INDEL. 

WARNINGS 

No check is done to see if a swap area being added overlaps 
with an existing swap area or file system. 
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NAME 

sync - update the super block 

SYNOPSIS 
sync 

DESCRIPTION 

Sync executes the sync system primitive. If the system is to 
be stopped, sync must be called to insure file system integrity. 
It will flush all previously unwritten system buffers out to disk, 
thus assuring that all file modifications up to that point will be 
saved. See sync (2) for details. 

NOTE 

If you have done a write to a file on a remote machine in a 
Remote File Sharing environment, you cannot use sync to 
force buffers to be written out to disk on the remote machine. 
Sync will only write local buffers to local disks. 

SEE ALSO 

sync (2) in the Programmer's Reference Manual. 
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NAME 

sysadm - menu interface to do system administration 

_ SYNOPSIS 

\^ ) sysadm [ sub-command ] 

DESCRIPTION 

This command, when invoked without an argument, presents a 
menu of system administration sub-commands, from which 
the user selects. If the optional argument is presented, the 
named sub-command is run or the named sub-menu is 
presented. 

The sysadm command may be given a password. See 
admpasswd in the Subcommands section. 

Subcommands 

The following menus of subcommands are available. The 
number of bullets ( • ) in front of each item indicates the level 
of the menu or subcommand. 

• diskmgmt 

„ H Hard disk management menu. 

w" The subcommands in this menu provide functions for 

using hard disks. The subcommands include the ability to 
check the file system, copy disks, format disks, make file 
systems, and mount and unmount disk file systems. 

• • checkfsys 

Check and repair file systems on hard disk. 

Checkfsys checks a file system on a hard disk for errors. 
If there are errors, this procedure attempts to repair them. 

• • cpdisk 

Make copies of one portion of a hard disk. 

This procedure makes a copy of the content of a speci- 
fied portion of a hard disk to another hard disk. 

• • display 

,~ Display hard disk partitioning. 

v.- ■'' Display allows the user to display the hard disk partition- 

ing. This informs the user of current disk partitioning 
information. 
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• format 

Format hard disk. 

This command prepares a new hard disk for use. It 
requires a description file for the type of hard disk that 
you want to format. Formatting removes all existing data 
from the disk, effectively erasing it. 

• makefsys 

Create a new file system on a hard disk. 

Makefsys creates a new file syetem on a hard disk. After 
constructing the file system, the user can mount it to an 
existing directory for use. 

■ • mountfsys 

Mount a file system. 

Mountfsys mounts a file system to an existing directory. 
Mountfsys announces to the system that a block special 
device is available to the user from the mount point direc- 
tory. This directory must already exist; it becomes the 
name of the root of the newly mounted file system. 

• • umountfsys 

Unmount a file system. 

Umountfsys unmounts a file system which was previously 
mounted. 

• filemgmt 

File management menu. 

The subcommands,^ this menu allow the user to protect 
files on the hard disk file systems by copying them onto 
diskettes and later restoring them to the hard disk by 
copying them back. 



Page 2 UP-13529 



SYSAI)M(IM) 



f— 



Subcommands are also provided to determine which files 
might be best kept on diskette based on age or size. 

backup 

Back up files from integral hard disk to removable disk or 
tape. 

Backup saves copies of files from the integral hard disk 
file systems to removable disk or tape. There are two 
kinds of backups: 

COMPLETE - copies all files (useful in case of serious file 
system damage). 

INCREMENTAL - copies files changed since the last 
backup. 

The normal usage is to do a complete backup of each file 
system and then periodically do incremental backups. 
Two cycles are recommended (one set of complete back- 
ups and several incrementals to each cycle). Files backed 
up with backup are restored using restore. 

bupsched 

Backup reminder scheduling menu. 

Backup scheduling is used to schedule backup reminder 
messages and backup reminder checks. Backup rem- 
inder messages are sent to the console to remind the 
administrator to back up particular file systems when the 
machine is shut down or a reminder check has been run 
during the specified time period. 

Backup reminder checks specify particular times at which 
the system checks to see if any backup reminder mes- 
sages have been scheduled. 
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• • • schedcheck 

Schedule backup reminder checks. 

Backup reminder checks are run at specific times to 
check to see if any reminders are scheduled. The user 
specifies the times at which the check is to be run. 
Checks are run for the reminder messages scheduled by 
schedmsg. 

• • • schedmsg 

Schedule backup reminder message. 

Backup reminder messages are sent to the console if the 
machine is shut down or a reminder check has been 
scheduled. The user specifies the times at which it is 
appropriate to send a message and the file systems to be 
included in the message. 

• • diskuse 

Display how much of the hard disk is being used. 

Diskuse lets the user know what percentage of the hard 
disk is currently occupied by files. The list is organized by 
file system names. 

• • fileage 

List files older than a particular date. 

Fileage prints the names of all files older than the date 
specified by the user. If no date is entered, all files older 
than 90 days are listed. If no directory is specified to look 
in, the /usr/admin directory is used. 

• • filesize 

List the largest files in a particular directory. 

Filesize prints the names of the largest files in a specific 
directory. If no directory is specified, the /usr/admin 
directory is used. If the user does not specify how many 
large files to list, 10 files are listed. 
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• • restore 

Restore files from backup and store media to integral 
hard disk. 

f "\ Restore copies files from disks and tapes made by 

v ~ / backup and store back onto the hard disk. You can 

restore individual files, directories of files, or the entire 
contents of a disk or tape. The user can restore from 
both "incremental" and "complete" media. The user can 
also list the names of files stored on the disk or tape. 

• • store 

Store files and directories of files onto disk or tape. 

Store copies files from the integral hard disk to disk or 
tape and optionally allows the user to verify that they 
worked and remove them when done. Typically, these 
would be files that the user wants to archive or restrict 
access to. The user can store single files and directories 
of files. Use the restore command to put stored files 
back on the integral hard disk and to list the files stored. 

|C\ « machinemgmt 

K.J Machine management menu. 

Machine management functions are tools used to operate 
the machine; for example, turn it off or reboot. 

• • whoson 

Print list of users currently logged onto the system. 

Whoson prints the login ID, terminal device number, and 
sign-on time of all users who are currently using the com- 
puter. 

• packagemgmt 

Package management. 

These submenus and subcommands manage various 
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software and hardware packages that you install on your 
machine. Not all optional packages add subcommands 
here. 

• softwaremgmt 

Software management menu. 

These subcommands permit the user to install new 
software, remove software, and run software directly from 
the removable disk it is delivered on. The removekpg and 
runpkg capabilities are dependent on the particular 
software packages. See the instructions delivered with 
each package. 

• • installpkg 

Install new software package onto integral hard disk. 

Install copies files from removable disk onto the integral 
hard disk and performs additional work if necessary so 
that the software can be run. From then on, the user will 
have access to those commands. 

• • Ustpkg 

List packages already installed. 

This subcommand show you a list of currently installed 
optional software packages. 

• • removepkg 

Remove previously installed package from integral hard 
disk. 

This subcommand displays a list of currently installed 
optional software packages. Actions necessary to remove 
the software packages specified by the user will then be 
performed. The removable disk used to installpkg the 
software is needed to remove it. 

• • runpkg 

Run software package without installing it. 

This package allows the user to run software from a 
removable disk without installing it permanently on the 
system. This is useful if the user does not use the 
software often or does not have enough room on the sys- 
tem. WARNING: not all software packages have the abil- 
ity to run their contents this way. See the instructions 
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that come with the software package. 

• syssetup 

System setup menu. 

System setup routines allow the user to tell the computer 
what its environment looks like: what the date, time, and 
time zone are, what administration and system capabilities 
are to be under password control, what the machine's 
name is, and so forth. The first-time setup sequence is 
also here. 

• • admpasswd 

Assign or change administrative passwords. 

Admpasswd lets you set or make changes to passwords 
for administrative commands and logins such as setup 
and sysadm. 

• • datetime 

Set the date, time, time zone, and daylight savings time. 

Datetime tells the computer the date, time, time zone, 
and whether you observe Daylight Savings Time (DST). It 
is normally run once when the machine is first set up. If 
you observe DST, the computer will automatically start to 
observe it in the spring and return to Standard Time in 
the fall. The machine has to be turned off and turned 
back on again to guarantee that all times are reported 
correctly. Most are correct the next time the user logs in. 

• • nodename 

Set the node name of this machine. 

This command allows you to change the node name of 
this machine. The node name is used by various com- 
munications networks to identify this machine. 

• • setup 

Set up your machine the very first time. 

Setup allows the user to define the first login, to set the 
passwords on the user-definable administration logins, 
and to set the time zone for your location. 

• • syspasswd 

Assign system passwords. - 
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Syspasswd lets the user set system passwords normally 
reserved for the very knowledgeable user. For this rea- 
son, this procedure may assign those passwords, but may 
not change or clear them. Once set, they may only be 
changed by the specific login or the "root" login. 

ttymgmt 

Terminal management. 

This procedure allows the user to manage the computer's 
terminal functions. 

• • lineset 

Show tty line settings and hunt sequences. 

The tty line settings are often hunt sequences where, if 
the first line setting does not work, the line "hunts" to the 
next line setting until one that does work comes by. This 
subcommand shows the various sequences with only 
specific line settings in them. It also shows each line set- 
ting in detail. 

• • mkltneset 

Create new tyy line settings and hunt sequences. 

This subcommand helps you to create tty line setting 
entries. You might want to add line settings that are not 
in the current set or create hunt sequences with only 
specific line settings in them. The created hunt 
sequences are circular; stepping past the last setting puts 
you on the first. 

• • modtty 

Show and optionally modify characteristics of tty lines. 

This subcommand reports and allows you to change the 
characteristics of tty lines (also called "ports"). 

• usermgmt 

User management menu. 

These subcommands allow you to add, modify and delete 
the list of users that have access to your machine. You 
can also place them in separate groups so that they can 
share access to files within the group but protect them- 
selves from other groups. 
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• • addgroup 

Add a group to the system. 

Addgroup adds a new group name or ID to the computer. 
Group names and IDs are used to identify groups of 
users who desire common access to a set of files and 
directories. 

• • adduser 

Add a user to the system. 

Adduser installs a new login ID on the machine. You are 
asked a series of questions about the user and then the 
new entry is made. You can enter more than one user at 
a time. Once this procedure is finished, the new login ID 
is available. 

• • delgroup 

Delete a group from the system. 

Delgroup allows you to remove groups from the com- 
puter. The deleted group is no longer identified by name. 
However, files may still be identified with the group ID 
number. 

• • deluser 

Delete a user from the system. 

Deluser allows you to remove users from the computer. 
The deleted user's files are removed from the hard disk 
and their logins are removed from the /etc/passwd file. 

• • Isgroup 

List groups in the system. 

Lsgroup lists all the groups that have been entered into 
the computer. This list is updated automatically by add- 
group and delgroup. 

• • Isuser 

List users in the system. Lsuser lists all the users that 
have been entered into the computer. This list is updated 
automatically by adduser and deluser. 

• • modadduser 

Modify defaults used by adduser. 

Modadduser allows the user to change some of the 
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defaults used when adduser creates a new login. Chang- 
ing the defaults does not effect any existing logins, only 
logins made from this point on. 

• • modgroup 

Make changes to a group on the system. 

Modgroup allows the user to change the name of a 
group that the user enters when addgroup is run to set 
up new groups. 

• • moduser 

Menu of commands to modify a user's login. 

This menu contains commands that modify the various 
aspects of a user's login. 

• • • chgloginid 

Change a user's login ID. 

This procedure allows the user to change a user's login 
ID. Administrative and system logins cannot be changed. 

• • • chgpasswd 

Change a user's password. 

This proceudure allows removal or change of a user's 
password. Administrative and system login passwords 
cannot be changed. To change administrative and sys- 
tem login passwords, see the system setup menu: 
sysadm syssetup. 

• • • chgshell 

Change a user's login shell. 

This procedure allows the user to change the command 
run when a user logs in. The login shell of the administra- 
tive and system logins cannot be changed by this pro- 
cedure. 

FILES 

The files that support sysadm are found in /usr/admin. 

The menu starts in directory /usr/admin/menu. 



Page 10 UP-13529 



SYSDEF ( I M) 



NAME 

sysdef - output system definition 

SYNOPSIS 

/etc/sysdef [ system_namelist [ master ] ] 

DESCRIPTION 

Sysdef outputs the current system definition in tabular form. 
It lists all hardware devices as well as pseudo devices, system 
devices, and the values of all tunable parameters. It gen- 
erates the output by analyzing the named operating system 
file (system jiamelist) and extracting the configuration infor- 
mation from the name list itself. 

FILES 

/unix default operating system file (where the 

system namelist is) 

/etc/master default master file 

SEE ALSO 

nlist(3C), master(4) in the Programmer's Reference Manual. 



t v J DIAGNOSTICS 



internal name list overflow 

if the master table contains more than an internally speci- 
fied number of entries for use by nlist (3C). 

WARNING 

Sysdef displays information about configured devices only, not 
loaded devices. Use tddrv{WA) to obtain information about 
loaded device drivers. 
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NAME 

tic - terminfo compiler 

SYNOPSIS 

tic [ -v [ n ] ] [ -c ] file 

DESCRIPTION 

Tic translates a terminfo (4) file from the source format into the 
compiled format. The results are placed in the directory 
/usr/lib/terminfo. The compiled format is necessary for use 
with the library routines described in curses (3X). 

-vn (verbose) Output to standard error trace information 
showing tic'sprogress. The optional integer n is a 
number from 1 to 10, inclusive, indicating the desired 
level of detail of information. If n is omitted, the 
default level is 1. If n is specified and greater than 1, 
the level of detail is increased. 

-c Only check file for errors. Errors in use= links are 

not detected. 

file Contains one or more terminfo(4) terminal descrip- 

tions in source format [see terminfo (4)]. Each 
description in the file describes the capabilities of a 
particular terminal. When a use = enfry-name field is 
discovered in a terminal entry currently being com- 
piled, tic reads in the binary from /usr/lib/terminfo to 
complete the entry. (Entries created from file will be 
used first. If the environment variable TERMINFO is 
set, that directory is searched instead of 
/usr/lib/terminfo.) 77c duplicates the capabilities in 
entry-name for the current entry, with the exception 
of those capabilities that explicitly are defined in the 
current entry. 

If the environment variable TERMINFO is set, the compiled 
results are placed there instead of /usr/lib/terminfo. 

FILES 

/usr/lib/terminfo/?/* compiled terminal description data 

base 

SEE ALSO 

curses(3X), term(4), terminfo(4) in the Programmer's Refer- 
ence Manual. 
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"curses/terminfo" in the System V Operating System 
Programmer's Guide. 

WARNINGS 

Total compiled entries cannot exceed 4096 bytes. The name 
field cannot exceed 128 bytes. 

Terminal names exceeding 14 characters will be truncated to 
14 characters and a warning message will be printed. 

When the -c option is used, duplicate terminal names will not 
be diagnosed; however, when -c is not used, they will be. 

BUGS 

To allow existing executables from UNIX System V Release 2 
to run with the compiled terminfo entries created by the new 
terminfo compiler, cancelled capabilities will not be marked as 
cancelled within the terminfo binary unless the entry name has 
a ' + ' within it. (Such terminal names are only used for inclu- 
sion within other entries via a use = entry. Such names would 
not be used for real terminal names.) 

For example: 

4415+nl, kfl®, kf28, 

4415+base, kf1=\E0c, kf2=\E0d, .... 

4415-nl|4415 terminal without keys, 
use=4415+nl , use=4415+base. 

The above example works as expected; the definitions for the 
keys do not show up in the 4415-nl entry. However, if the 
entry 4415 + nl did not have a plus sign within its name, the 
cancellations would not be marked within the compiled file and 
the definitions for the function keys would not be cancelled 
within 4415-nl. 
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DIAGNOSTICS 

Most diagnostic messages produced by tic during the compi- 
f"'--\ lation of the source file are preceded with the approximate line 

V_/ number and the name of the terminal currently being worked 

on. 

mkdir . . . returned bad status 

The named directory could not be created. 

File does not start with terminal names in column one 

The first thing seen in the file, after comments, must be 
the list of terminal names. 

Token after a seek(2) not NAMES 

Somehow the file being compiled changed during the 
compilation. 

Not enough memory for usejist element 

or 

Out of memory 

Not enough free memory was available (malloc (3C) 

failed). 

Can't open . . . 

The named file could not be created. 



k ) 



Error in writing . . . 

The named file could not be written to. 

Can'f link ...to ... 
A link failed. 

Error in re-reading compiled file . . . 

The compiled file could not be read back in. 

Premature EOF 

The current entry ended prematurely. 

Backspaced off beginning of line 

This error indicates something wrong happened within tic. 

Unknown Capability - ". . ." 

^-^ The named invalid capability was found within the file. 

f \ 
\^,J Wrong type used for capability ". . ." 

For example, a string capability was given a numeric 

value. 



UP-13529 Page 3 



TIC(IM) 



Unknown token type 

Tokens must be followed by '(§>' to cancel, ',' for boole- 

ans, '#' for numbers, or ' = ' for strings. ^^ 

". . .": bad term name V.,- 

or 

Line . . . : Illegal terminal name - ". . ." 

Terminal names must start with a letter or digit 

The given name was invalid. Names must not contain 
white space or slashes, and must begin with a letter or 
digit. 

". . .": terminal name too long. 

An extremely long terminal name was found. 

". . .": terminal name too short. 
A one-letter name was found. 

". . ." filename too long, truncating to ". . ." 

The given name was truncated to 14 characters due to 
System V file name length limitations. 

". . ." defined in more than one entry. Entry being used /P - 

is ". . .". 

An entry was found more than once. ***"** 

Terminal name ". . ." synonymfor itself . 

A name was listed twice in the list of synonyms. 

At least one synonym should begin with a letter. 

At least one of the names of the terminal should begin 
with a letter. 

Illegal character - ". . ." 

The given invalid character was found in the input file. 

Newline in middle of terminal name 

The trailing comma was probably left off of the list of 
names. 

Missing comma 

A comma was missing. 

Missing numeric value f\ 

The number was missing after a numeric capability. KJ 

NULL string value 

The proper way to say that a string capability does not 
exist is to cancel it. 
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Very long string found. Missing comma? 
Self-explanatory. 

Unknown option. Usage is: 

An invalid option was entered. 

Too many file names. Usage is: 
Self-explanatory. 

". . ." non-existant or permission denied 

The given directory could not be written into. 

". . ." is not a directory 
Self-explanatory. 

". . .": Permission denied 
Access denied. 

". . .": Not a directory 

tic wanted to use the given name as a directory, but it 
already exists as a file. 

SYSTEM ERROR!! Fork failed!!! 
A fork {2) failed. 

Error in following up use-links. Either there is a loop 
in the links or they reference non-existent terminals. 
The following is a list of the entries involved: 

A terminfo(4) entry with a use = name capability either 
referenced a non-existant terminal called name or name 
somehow referred back to the given entry. 
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NAME 

tsdbadm - Remote Terminal service database administration 

SYNOPSIS 
tsdbadm 

DESCRIPTION 

Tsdbadm is a menu-driven administration tool used to modify 
the Remote Terminal service database (/usr/net/ 
adm/cfg/ttysrv.db). Using tsdbadm, you can: 

Change the default service 

Delete a service 

Add a new service 

Modify an existing service 

List available services. 

This database is used when a Remote Terminal service con- 
nection is established over an RFS network, for example, by 
using cu (1C) or uucp (1C). When an attempt is made to con- 
nect, the Remote Terminal service looks up the available ser- 
vices in the terminal service database. 

If only a single service is available, that service is automatically 
executed. If the Remote Terminal service database contains 
more than one service, the caller is prompted to specify the 
terminal service to be executed. 

Each entry in the Remote Terminal service database has three 
fields: Name, Description, and Command Line. 

where 

Name 

is the name of the service. This name must be unique, a 
single word, and no more than 14 characters. 

Description 

is a brief description of the service. The description is lim- 
ited to a single line, no more than 60 characters. 

Command Line 

is the command line to be executed when this service is 
selected. This can be a full command line with options 
and arguments. 
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FILES 

/usr/net/adm/cfg/ttysrv.db 

SEE ALSO 

tslimit(IM). 
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NAME 

tslimit - Remote Terminal service limits administration 

SYNOPSIS 

tslimit [ -? ] [ -c count ] [ -m max_count ] [ -r] 

DESCRIPTION 

Tslimit is used to display or update the current count and 
maximum allowed number of remote terminal servers. When 
used with no options, tslimit sets the maximum allowed 
number of remote terminal servers to a default value of 16, 
and leaves the current count unchanged. 

This limit applies to Remote Terminal connections established 
over an RFS network, for example by using cu(1C) or 
uucp (1C) . 

The following options are recognized: 

-? displays a brief description of the command. 

-c count 

changes the current count of remote terminal servers to 
count . This option is needed only when the count is out 
of sync with the actual number of remote terminal servers 
running. This count is automatically incremented and 
decremented by the Remote Terminal service, and does 
not normally need to be modified. 

-m max_count 

changes the maximum number of remote terminal servers 
to max_count, limiting the number of connections that can 
be made from other machines using the Remote Terminal 
service. 

-r retrieves the current values of count and max_count, and 
prints them to standard out. 

The current counf and max_count values are stored in a limits 
file (/usr/net/adm/cfg/ttysrv.pl). If the limits file doesn't exist, 
tslimit creates it. When the limits file is not present, no limit is 
imposed on the number of remote terminal connections. 

ERRORS 

An error message is printed to standard error if one of the fol- 
lowing is true: 
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• The limits file is currently being edited or referenced (lock 
file exists for the file). 

• You lack the prvileges needed to edit the limits file. 

• The number of remote terminal server processes currently 
running exceeds the new maximum limit. 

FILES 

/usr/net/adm/cfg/ttysrv.pl 
/usr/net/adm/tmp/ttysrv.cp 

SEE ALSO 

tsdbadm(IM). 
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NAME 

uadmin - administrative control 

SYNOPSIS 

/etc/uadmin cmd fen 

DESCRIPTION 

The uadmin command provides control for basic administra- 
tive functions. This command is tightly coupled to the System 
Administration procedures and is not intended for general use. 
It may be invoked only by the super-user. 

The arguments cmd (command) and fen (function) are con- 
verted to integers and passed to the uadmin system call. 

SEE ALSO 

uadmin (2) in the Programmer's Reference Manual. 



f" 
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NAME 

unadv - unadvertise a Remote File Sharing resource 

f^S SYNOPSIS 

K - unadv resource 

DESCRIPTION 

Unadv unadvertises a Remote File Sharing resource, which is 
the advertised symbolic name of a local directory, by remov- 
ing it from the advertised information on the domain name 
server. Unadv prevents subsequent remote mounts of that 
resource. It does not affect continued access through existing 
remote or local mounts. 

An administrator at a server can unadvertise only those 
resources that physically reside on the local machine. A 
domain administrator can unadvertise any resource in the 
domain from the primary name server by specifying resource 
name as domain.resource. (A domain administrator should 
only unadvertise another hosts resources to clean up the 
domain advertise table when that host goes down. Unad- 

f"~\ vertising another host's resource changes the domain adver- 

Vw tise table, but not the host advertise table.) 

This command is restricted to the super-user. 

ERRORS 

If resource is not found in the advertised information, an error 
message will be sent to standard error. 

SEE ALSO 

adv(1M), fumount(IM), nsquery(IM). 



\ J 
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NAME 

uucheck - check the uucp directories and permissions file 

SYNOPSIS 

/usr/lib/uucp/uucheck f -v ] [ -x debugjevel ] 

DESCRIPTION 

uucheck checks for the presence of the uucp system required 
files and directories. Within the uucp makefile, it is executed 
before the installation takes place. It also checks for some 
obvious errors in the Permissions file 

(/usr/lib/uucp/Permissions). When executed with the -v 
option, it gives a detailed explanation of how the uucp pro- 
grams will interpret the Permissions file. The -x option is used 
for debugging. Debug-option is a single digit in the range 1-9; 
the higher the value, the greater the detail. 

Note that uucheck can only be used by the super-user or 
uucp. 

FILES 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuscheds 

/usr/lib/uucp/Maxuuxqts 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

SEE ALSO 

uucico(1M), uusched(IM). 

uucp(1C), uustat(1C), uux(1C) in the User's Reference 

Manual. 

BUGS 

The program does not check file/directory modes or some 
errors in the Permissions file such as duplicate login or 
machine name. 
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NAME 

uucico - file transport program for the uucp system 

SYNOPSIS 

/usr/lib/uucp/uucico [ -r rolejiumber ] [ -x debugjevel ] 
[ -i interface ] [ -d spool_directory ] -s systemjiame 

DESCRIPTION 

Uucico is the file transport program for uucp work file 
transfers. Role numbers for the -r are the digit 1 for master 
mode or for slave mode (default). The -r option should be 
specified as the digit 1 for master mode when uucico is 
started by a program or cron. Uux and uucp both queue jobs 
that will be transferred by uucico. It is normally started by the 
scheduler, uusched, but can be started manually; this is done 
for debugging. For example, the shell Uutry starts uucico with 
debugging turned on. A single digit must be used for the -x 
option with higher numbers for more debugging. 

The -i option defines the interface used with uucico. This 
interface only affects slave mode. Known interfaces are UNIX 
(default), TLI (basic Transport Layer Interface), and TLIS (Tran- 
sport Layer Interface with Streams modules, read/write). 

FILES 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Devconfig 

/usr/lib/uucp/Sysfiles 

/usr/lib/uucp/Maxuuxqts 

/usr/lib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

SEE ALSO 

cron(lM), uusched(IM), uutry(1M). 

uucp(lC), uustat(1C), uux(1C) in the User's Reference 

Manual. 
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NAME 

uucleanup - uucp spool directory clean-up 

SYNOPSIS 

/usr/lib/uucp/uucleanup [ -Ctime ] [ -Wf/me ] [ -Xtime ] 
[ -mstring ] [ -of/me ] [ -ssystem ] 

DESCRIPTION 

Uucleanup will scan the spool directories for old files and take 
appropriate action to remove them in a useful way: 

• Inform the requestor of send/receive requests for systems 
that can not be reached. 

• Return mail which cannot be delivered to the sender. 

• Delete or execute mews for rnews type files (depending 
on where the news originated - locally or remotely). 

• Remove all other files. 

In addition, there is provision to warn users of requests that 
have been waiting for a given number of days (default 1). 
Note that uucleanup will process as if all option times were 
specified to the default values unless time is specifically set. 

The following options are available. 

-Ctime Any C. files greater or equal to time days old will 
be removed with appropriate information to the 
requestor, (default 7 days) 

-Dtime Any D. files greater or equal to time days old will be 
removed. An attempt will be made to deliver mail 
messages and execute rnews when appropriate 
(default 7 days). 

-Wr/me Any C. files equal to time days old will cause a mail 
message to be sent to the requestor warning about 
the delay in contacting the remote. The message 
includes the JOBID, and in the case of mail, the 
mail message. The administrator may include a 
message line telling whom to call to check the 
problem (-m option) (default 1 day). 

•Xtime Any X. files greater or equal to time days old will be 
removed. The D. files are probably not present (if 
they were, the X. could get executed). But if there 
are D. files, they will be taken care of by D. 
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•mstring 



•otime 



processing (default 2 days). 

This line will be included in the warning message 
generated by the -W option. The default line is 
"See your local administrator to locate the prob- 
lem". 



Other files whose age is more than time days will 
be deleted (default 2 days). 

-ssysfem Execute for system spool directory only. 

-xdebugjevel 

The -x debug level is a single digit between and 
9; higher numbers give more detailed debugging 
information. (If uucleanup was compiled with - 
DSMALL, no debugging output will be available.) 

This program is typically started by the shell 
uudemon.cleanup, which should be started by cro/7(1M), 

FILES 

/usr/lib/uucp directory with commands used by 

uucleanup internally 

/usr/spool/uucp spool directory 

SEE ALSO 

cron(1M). 

uucp(lC), uux(1C) in the User's Reference Manual. 
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NAME 

uugetty - set terminal type, modes, speed, and line discipline 

SYNOPSIS 

/usr/Hb/uucp/getty [ -h ] [ -t timeout ] [ -r ] 
line [ speed [ type [ linedisc ] ] ] 

/usr/lib/uucp/getty -c file 

DESCRIPTION 

Uugetty is identical to ge/fy(1M) but changes have been made 
to support using the line for uucico, cu, and ct; that is, the 
line can be used in both directions. The uugetty command will 
allow users to login, but if the line is free, uucico, cu, or ct 
commands can use it for dialing out. The implementation 
depends on the fact that uucico, cu, and ct create lock files 
when devices are used. When the open() returns (or the first 
character is read when -r option is used), the status of the 
lock file indicates whether the line is being used by uucico, cu, 
ct, or someone trying to login. Note that in the -r case, 
several < carriage- return > characters may be required before 
the login message is output. The human users will be able to 
handle this slight inconvenience. Uucico trying to login will 
have to be told by using the following login script: 

"" \r\d\r\d\r\d\r in:-- In: ... 

where the . . . is whatever would normally be used for the login 
sequence. 

The following /etc/inittab entry can be used for an intelligent 
modem or a direct line: 

002:2:respawn:/usr/lib/uucp/uugetty -r -t 60 tty002 1200 

An entry for an intelligent modem or direct line that has a 
uugetty on each end must use the -r option. (This causes 
uugetty to wait to read a character before it puts out the login 
message, thus preventing two uugettys from looping.) If there 
is a uugetty on one end of a direct line, there must be a 
uugetty on the other end as well. Here is an /etc/inittab entry 
using uugeffy on an intelligent modem or direct line: 

30:2:respawn:/usr/lib/uucp/uugetty -r -t 60 tty12 1200 

FILES 

/etc/gettydefs 
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/etc/issue 

SEE ALSO 

uucico(1M), getty(1M), init(1M), tty(7). /* 

ct(1C), cu(1C), login (1) in the User's Reference Manual. \_ 

ioctl(2), gettydefs(4), inittab(4) in the Programmer's Reference 
Manual. 

BUGS 

Ct will not work when uugetty is used with an intelligent 
modem such as Penril or Ventel. 



Page 2 UP-13529 



UUSCHED(IM) 



NAME 

uusched - the scheduler for the uucp file transport program 
r"\ SYNOPSIS 

v. „ J /usr/lib/uucp/uusched [ -x debug level ] [ -u debugjevel 

] 
DESCRIPTION 

Uusched is the uucp file transport scheduler. It is usually 
started by the daemon uudemon.hour that is started by 
cron(lM) from an entry in /usr/spool/cron/crontabs: 

39 * * * * /bin/su uucp -c "/iisr/lib/uucp/uudemon.hour 
> /dev/null" 

The two options are for debugging purposes only; -x 
debugjevel will output debugging messages from uusched 
and -u debugjevel will be passed as -x debugjevel to 
uucico. The de~bugjevel is a number between and 9; higher 
numbers give more detailed information. 

FILES 

f2"\ /usr/lib/uucp/Systems 

v_> /usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/spool/uucp/* 
' /usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

SEE ALSO 

cron(1M), uucico(1M). 

uucp(lC), uustat(1C), uux(1C) in the User's Reference 

Manual. 



c 
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NAME 

Uutry - try to contact remote system with debugging on 

SYNOPSIS 

/usr/lib/uucp/Uutry [ -x debugjevel ] [ -r ] systemjiame 

DESCRIPTION 

Uutry is a shell that is used to invoke uucico to call a remote 
site. Debugging is turned on (default is level 5); -x will over- 
ride that value. The -r overrides the retry time in 
/usr/spool/uucp/. status. The debugging output is put in file 
/tmp/system_name. A tail -f of the output is executed. A 
< DELETE > or < BREAK > will give control back to the termi- 
nal while the uucico continues to run, putting its output in 
/tmp/sysfem_name. 

FILES 

/usr/lib/uucp/Systems 

/usr/lib/uucp/Permissions 

/usr/lib/uucp/Devices 

/usr/lib/uucp/Maxuuxqts 

/usr/iib/uucp/Maxuuscheds 

/usr/spool/uucp/* 

/usr/spool/locks/LCK* 

/usr/spool/uucppublic/* 

/tmp/system_name 

SEE ALSO 

uucico(1M). 

uucp(1C), uux(1C) in the User's Reference Manual. 
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NAME 

uuxqt - execute remote command requests 

SYNOPSIS 

/usr/lib/uucp/uuxqt [ -s system ] [ -x debugjevel ] 

DESCRIPTION 

Uuxqt is the program that executes remote job requests from 
remote systems generated by the use of the uux command. 
(Mail uses uux for remote mail requests). Uuxqt searches the 
spool directories looking for X. files. For each X. file, uuxqt 
checks to see if all the required data files are available and 
accessible, and file commands are permitted for the request- 
ing system. The Permissions file is used to validate file acces- 
sibility and command execution permission. 

There are two environment variables that are set before the 
uuxqt command is executed: 

UU_MACHINE is the machine that sent the job (the previous 
one). 

UUJJSER is the user that sent the job. 

These can be used in writing commands that remote systems 
can execute to provide information, auditing, or restrictions. 

The -x debugjevel is a single digit between and 9. Higher 
numbers give more detailed debugging information. 

FILES 

/usr/lib/uucp/Permissions 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/locks/LCK* 

SEE ALSO 

uucico(1M). 

uucp(1C), uustat(lC), uux(1G), mail(1) in the User's Reference 

Manual. 
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NAME 

volcopy - copy file systems with label checking 

SYNOPSIS 

/etc/volcopy [ options ] fsname special 1 volnamel special 
volname2 

DESCRIPTION 

Volcopy makes a literal copy of the file system using a block- 
size matched to the device. Options are: 

-a Invoke a verification sequence requiring a positive opera- 
tor response instead of the standard 10-second delay 
before the copy is made. 

-s (default) Invoke the DEL If wrong verification sequence. 

-to The output file is a disk section (also called slice or parti- 
tion), but is to be treated like a tape. 

-ti The input file is a disk section, but is to be treated like a 
tape. 

Other options are used only with tapes: 

-bpidensity Bits- par-inch (specifically, 800/1 600/6250) , 

•feetsize Size of reel in feet (specifically, 1200/2400), 

-reelnum Beginning reel number for a restarted copy, 

-buf Use double buffered I/O. 

-Q Use -bpi and -feet values appropriate for 

quarter-inch tape cartridge. 

If -tl or -to is specified, the "reel" capacity is simply the size of 
the disk section; the "reel" is assumed to be on a removable 
disk, such as a floppy. 

For a true tape such as half-inch reel-to-reel or quarter-inch 
cartridge, capacity is derived from tape length and density. 
The program requests length and density information if it is 
not given on the command line or is not recorded on an input 
tape label. If the file system is too large to fit on one reel, vol- 
copy will prompt for additional reels. Labels of all reels are 
checked. Tapes may be mounted alternately on two or more 
drives. If volcopy is interrupted, it will ask if the user wants to 
quit or wants a shell. In the latter case, the user can perform 
other operations [such as /aoe//f(1M)] and return to volcopy 
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by exiting the new shell. 

The fsname argument represents the mounted name (for 
example, root, u1) of the file system being copied. Use the 
labelit (1M) command to display the fsname of a file system 
for use with volcopy, or to assign a name to a file system if 
this has not already been done. 

The special should be the physical disk section or tape (for 
example /dev/rdsk/c0d0s5, /dev/rmtO). 

The volname is the physical volume name (for example, pk3, 
t0122, and so forth) and should match the external label 
sticker. Such label names are limited to six or fewer charac- 
ters. Volname may be - to use the existing volume name. 

Speciall and volname! are the device and volume from which 
the copy of the file system is being extracted. Special2 and 
volname2 are the target device and volume. 

Fsname and volname are recorded in the last 12 characters of 
the superblock (char fsname[6], votname[6];). 

FILES 

/etc/log/filesave.log a record of file systems/volumes 

copied 

EXAMPLE 

The following command backs up the root file system to a 
tape: 

volcopy -a root /dev/rdsk/cOdOsI do /dev/rmtO epoch! 

SEE ALSO 

labelit(IM). 

fs(4) in the Programmer's Reference Manual. 

sh(1) in the User's Reference Manual. 

WARNINGS 

Volcopy does not support tape- to- tape copying. Use dd (1M) 
for tape-to-tape copying. 

BUGS 

Only device names beginning /dev/rmt are automatically 
treated as tapes. Tape record sizes are determined both by 
density and by drive type. For half-inch tapes, records are 
5,120 bytes long at 800 and 1600 bits-per-inch, and 25,600 
bytes long at 6250 bits-per-inch. 
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NAME 

whodo - who is doing what 

SYNOPSIS 
/etc/whodo 

DESCRIPTION 

Whodo produces formatted and dated output from informa- 
tion in the /etc/utmp and /etc/ps_data files. 

The display is headed by the date, time, and machine name. 
For each user logged in, device name, user-ID, and login time 
are shown, followed by a list of active processes associated 
with the user-ID. The list includes the device name, process-ID, 
CPU minutes and seconds used, and process name. 

EXAMPLE 

The command: 

whodo 
produces a display like this: 






Tue Mar 12 


15:48:03 1985 


bailey 




tty09 men 8:51 


tty09 


28158 0:29 sh 


tty52 bdr 15:23 


tty52 


21688 0:05 sh 


tty52 


22788 0:01 whodo 


tty52 


22017 0:03 vi 


tty52 


22519 0:01 sh 


xt162 lee 10:20 


xt162 


6751 0:01 sh 


xt163 


6761 0:05 sh 


ttyOS 


6536 0:05 sh 


FILES 




/etc/passwd 




/etc/ps_data 




/etc/utmp 




SEE ALSO 




ps(1), who(1) in the User's Reference Manual 
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NAME 

intro - introduction to special files 

-. DESCRIPTION 

f 

V_ > This section describes various special files that refer to specific 

hardware peripherals and 6000/50 system device drivers, 
including networking protocol drivers. Features common to a 
set of protocols are documented as a protocol family. 
STREAMS [see intro (2)] software drivers, modules and the 
STREAMS-generic set of focf/(2) system calls are also 
described. 

Hardware Entries 

For hardware related files, the names of the entries are gen- 
erally derived from names for the hardware, as opposed to 
the names of the special files themselves. Characteristics of 
both the hardware device and the corresponding 6000/50 sys- 
tem device driver are discussed where applicable. 

Disk device file names are in the following format: 

_ /dev/{r}dsk/c#d#s# 

V.,* where r indicates a raw interface to the disk, c# indicates the 

controller number, d# indicates the device attached to the 
controller and s# indicates the section number of the parti- 
tioned device. 

Protocol Family Entries 

A protocol family provides basic services to the protocol imple- 
mentation to allow it to function within a specific network 
environment. These services may include packet fragmenta- 
tion and reassembly, routing, addressing, and basic transport. 
A protocol family may support multiple methods of address- 
ing, though the current protocol implementations do not. A 
protocol family is normally comprised of a number of proto- 
cols, one per socfcef{2B) type. It is not required that a proto- 
col family support all socket types. A protocol family may 
contain multiple protocols supporting the same socket 
, —, abstraction. 

V,^ A protocol supports one of the socket abstractions detailed in 

socket (2B). A specific protocol may be accessed by creating 
a socket of the appropriate type and protocol family, by 
requesting the protocol explicitly when creating a socket, by 
executing the appropriate TLI primitives, or by opening the 
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associated STREAMS device. 

Protocol Entries 

The system currently supports the DARPA Internet protocols. 
Raw socket interfaces are provided to the IP protocol layer of 
the DARPA Internet and to ICMP protocol. Consult the 
appropriate entries in this section for more information. 

Routing Ioctls 

The network facilities provide limited packet routing. A simple 
set of data structures comprise a "routing table" used in 
selecting the appropriate network interface when transmitting 
packets. This table contains a single entry for each route to a 
specific network or host. A user process, the routing daemon, 
maintains this data base with the aid of two socket-specific 
ioctl(2) commands, SOICADDRT and SOICDELRT. The com- 
mands allow the addition and deletion of a single routing table 
entry, respectively. Routing table manipulations may only be 
carried out by the super-user. 

A routing table entry has the following form, as defined in 
< net/route.h > : 

struct rtentry \ 

u_long rtjiash; 
struct sockaddr rt_dst; 
struct sockaddr rt_gateway; 
short rt_f1ags; 
short rt_refcnt; 
u_long rt_use; 
struct if net *rt_ifp; 
I; 
The rt_flags are defined as follows: 



^define 


RTFJJP 0x1 


/* route usable*/ 


#define 


RTF_GATEWAY 0x2 


/* destination is a gateway */ 


#define 


RTF_H0ST 0x4 


/* host entry (net otherwise) */ 


#define 


RTF_DYNAMIC 0x10 


/* created dynamically */ 
/* (by redirect) */ 



Routing table entries are of three general types: those for a 
specific host, those for all hosts on a specific network, and 
those for any destination not matched by entries of the first 
two types (a wildcard route). When the system is booted and 
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addresses are assigned to the network interfaces, each proto- 
col family installs a routing table entry for each interface when 
^ it is ready for traffic. Normally the protocol specifies the route 

( ) through each interface as a "direct" connection to the destina- 

v ~" tion host or network. If the route is direct, the transport layer 

of a protocol family usually requests the packet be sent to the 
same host specified in the packet. Otherwise, the interface is 
requested to address the packet to the gateway listed in the 
routing entry (that is, the packet is forwarded). Some routing 
entries specify a connection requiring some form of dialing. 

Routing table entries installed by a user process may not 
specify the hash, reference count, use, or interface fields; 
these fields are filled in by the routing routines. If a route is in 
use when it is deleted (rt_refcnt is non-zero), the routing entry 
is marked down and removed from the routing table, but the 
resources associated with it are not reclaimed until all refer- 
ences to it are released. The routing code returns EEXIST if 
requested to duplicate an existing entry, ESRCH if requested 
to delete a non-existent entry, or ENOSR if insufficient 
€ "| resources were available to install a new route. User 

^■— / processes read the routing tables through the /dev/kmem 

device. The rt_use field contains the number of packets sent 
along the route. 

When routing a packet, the kernel first attempts to find a 
route to the destination host. Failing that, a search is made 
for a route to the network of the destination. Finally, any 
route to a default ("wildcard") gateway is chosen. If multiple 
routes are present in the table, the first route found is used. If 
no entry is found, the destination is declared to be unreach- 
able. 

A wildcard routing entry is specified with a zero destination 
address value. Wildcard routes are used only when the sys- 
tem fails to find a route to the destination host and network. 
The combination of wildcard routes and routing redirects can 
provide an economical mechanism for routing traffic. 

Qj Interface IOCTLs 

Each network interface in a system corresponds to a path 
through which messages may be sent and received. A net- 
work interface usually has a hardware device associated with 
it, although certain interfaces such as the loopback interface, 
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to(7B), do not. 

The following ioctl calls may be used to manipulate network 
interfaces. The ioctl is made on a socket (typically of type 
SOCK_DGRAM) in the desired "communications domain" [see 
profoco/s(4B)]. Unless specified otherwise, the request takes 
an ifrequest structure as its parameter. This structure has the 
form: 



struct 



ifreq } 
char 

union j 



ifr_name[16]; /* name of interface */ 
/* (e.g. ecO) */ 



struct 
struct 
struct 
short 
int 
J ifr_ifru; 



sockaddr ifru_addr; 
sockaddr ifru_dataddr; 
sockaddr ifru_broadaddr; 
ifru_flags; 
ifru_metric; 



^define 
^define 



ifr_addr ifr_ifru.ifru_addr /* address */ 

ifr_dstaddr ifr_ifru.ifru_dstaddr /* other end */ 

/* of p-to-p */ 

/* link */ 
jfdefine ifr_broadaddr ifr_ifru.ifru_broadaddr /* broadcast */ 

/* address */ 
ifr_flags ifr_ifru.ifru_flags /* flags */ 
ifrjnetric ifr_ifru.ifru_n»tric /* routing */ 

/* metric */ 



^define 
jjrdefine 



SIOCSIFADDR 

Set interface address for protocol family. Following the 
address assignment, the "initialization" routine for the 
interface is called. 

SIOCGIFADDR 

Get interface address for protocol family. 

SIOCSIFDSTADDR 

Set point-to-point address for protocol family and inter- 
face. 

SIOCGIFDSTADDR 

Get point-to-point address for protocol family and inter- 
face. 
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SIOCSIFBRDADDR 

Set broadcast address for protocol family and interface. 

SIOCGIFBRDADDR 

Get broadcast address for protocol family and interface. 

SOICSIFFLAGS 

Set interface flags field. If the interface is marked down, 
any processes currently routing packets through the inter- 
face are notified; some interfaces may be reset so that 
incoming packets are no longer received. When marked 
up again, the interface is reinitialized. 

SOICGIFFLAGS 

Get interface flags. 

SIOCSIFMETRIC 

Set interface routing metric. The metric is used only by 
user-level routers. 

SIOCGIFMETRIC 

Get interface metric. 

SIOCGIFCONF 

Get interface configuration list. This request takes an 
ifconf structure (see below) as a value-result parameter. 
The ifcjen field should be set initially to the size of the 
buffer pointed to by ifc_buf. On return it contains the 
length, in bytes, of the configuration list. 

/* Structure used in SIOCGIFCONF request. */ 
/* Used to retrieve interface configuration */ 
/* for machine (useful for programs which */ 
/* must Know all networks accessible). */ 

struct ifconf j 

int ifcjen; /* size of associated */ 

/* buffer */ 



union J 
i, ) I ifc_ifcu; 



caddr_t ifcujbuf; 
struct ifreq *ifcu_req; 



#define ifc_buf ifc_ifcu.ifcu_buf /* buffer address */ 
#define ifcjreq ifc_ifcu.ifcu_req /* array of structures */ 

/* returned */ 

I; 
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STREAMS Ioctl Interface 

Socket ioctl calls can also be issued using STREAMS file 
descriptors. The standard strioctl structure is used, with the 
ic_cmd field containing the socket ioctl code (from 
<sys/socket.h>) and the ic_db field pointing to the data 
structure appropriate for that ioctl. 

Options management is done using the TLI primitives and the 
following structure, which contains the arguments to the 
"sockopts" calls: 

struct optdesc f 

int level; /* Protocol Level Affected */ 

int optname; /* option name to modify */ 

int value; /* value set or retrieved */ 

u 

SEE ALSO 

ioctl(2), socket(2B) in the Programmer's Reference Manual. 
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NAME 

clone - open any minor device on a STREAMS driver 

^ DESCRIPTION 

V_ J Clone is a STREAMS software driver that finds and opens an 

unused minor device on another STREAMS driver. The minor 
device passed to clone during the open is interpreted as the 
major device number of another STREAMS driver for which an 
unused minor device is to be obtained. Each such open 
results in a separate stream to a previously unused minor dev- 
ice. 

The clone driver consists solely of an open function. This 
open function performs all of the necessary work so that sub- 
sequent system calls [including c/ose(2)] require no further 
involvement of clone. 

Clone will generate an ENXIO error, without opening the dev- 
ice, if the minor device number provided does not correspond 
to a valid major device, or if the driver indicated is not a 
STREAMS driver. 

{* ) CAVEATS 

Multiple opens of the same minor device cannot be done 
through the clone interface. Executing sfaf(2) on the file sys- 
tem node for a cloned device yields a different result from 
executing fstat [see sfaf(2)] using a file descriptor obtained 
from opening the node. 

SEE ALSO 

log(7). 

System V Operating System STREAMS Programmer's Guide. 



x,,J 



UP-13529 Page 1 



CLONE(7) 

[This page left blank.] 



i^si/ 



f > 



Page 2 UP-13529 



I)ISK(7) 



NAME 

disk - disk format and driver 



f"~\ 


SYNOPSIS 


{^J 


^include < sys/types.h > 




#include <sys/gdisk.h> 




#include <sys/gdioct!.h> 



DESCRIPTION 

The files /dev/dsk/cOdOsO through /dev/dsk/cxdxsx and 
/dev/rdsk/cOdOsO through /dev/rdsk/cxdxsx refer to disk dev- 
ice names and slices, where ex is the controller number (in 
case of SCSI, the host SCSI controller), dx is the drive 
number, sx is the slice number, and x is a hexadecimal digit. 
An r in the name indicates the character (raw) interface. 

The 6000/50 formats a disk with 512-byte physical sectors. 
Block input/output uses 1024-byte logical blocks. 

The logical block on cylinder 0, track contains the Volume 
Home Block, which describes the disk. The following structure 
^ defines the volume home block. 

5 struct vhbd J 

uint magic; /* disk format code */ 

int chksum; /* adjustment to 32 bit sum */ 

/* starting from magic for */ 
/* IK bytes sums to -1 */ 
struct gdswptr dsk; /* specific description of */ 

/* this disk */ 
struct partit partab[HAXSLICE];/* partition table */ 
struct resdes { /* reserved area for */ 

/* special files */ 
daddr_t blkstart; /*start logical block # */ 
ushort nblocks; /* length in logical blocks */ 
/* (zero implies not */ 
/* present) */ 
j resmap[8); 

^-^ /* resmap consists of the following entries: */ 
i % j /* loader area */ 
"" /* bad block table */ 

/* dump area */ 

/* bootable program, */ 

/* size determined by a. out format. nblocks=1 */ 
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char fpulled; /* dismounted last time? */ 
long time; /* time last came on line */ 
struct gdswprt2 dsk2; /* drive specific parameters */ 



struct partit_ext 



part_ext[MAXSUCE]; 



char sysres[198]; /* custom system area */ 
char reserved [256]; 



union f 






/* user area */ 


char 


usera[228]; 


/* user area */ 


struct | 








short 


cpiomagic, 
setmagic, 
cpiovol, 
pad; 


/* for cpfo backup, restor 




char 


usera[220]; 


/* to pad to same size */ 
/* as usera */ 




\ slua 


; 




1 ua; 








uint 


resvO; 






uint 


totalblks; 





i; 

^define VHB_MAGIC 0x55515651 /* magic number in disk vhb */ 



jfdefine cpioMagic 
^define setMagic 
^define cpioVol 



ua.slua. cpiomagic 
ua.sHua. setmagic 
ua.slua. cpiovol 



/* indexes into resmap */ 
^define INDLOADER ((short)O) 
#define INDBBTBL ( (short )1) 
#define 1NDDUMP (( short )2) 
#define INDBOOT ((short)3) 

struct gdswprt 1 

char name[6J; /* printf name */ 

ushort cyls; /* the number of cylinders for this */ 

/* disk */ 
ushort heads; /* number of heads per cylinder */ 
ushort psectrk; /* number of physical sectors per */ 

/* track */ 
ushort pseccyl; /* number of physical sectors per */ 

/* cylinder */ 



/"- 
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char flags; /* floppy density and high tech */ 

/* drive flags */ 
char step; /* reserved for future use */ 
ushort sectorsz; /* size of physical sectors */ 

/* (in bytes) */ 



In- 



struct gdswprt2 I 

short wpccyl; /* reserved for future use */ 
short unused[5]; 

uint lsectors; /* # of blocks for this disk */ 
uint reserved[6]; 

I; 

/* disk slice table */ 
struct part it { 

union j 

uint strk; /* start track number */ 

i sz; 

I; 

struct partit_ext [ 
ushort p_flat; 
ushort p_tag; 
uint reserved; 

n 

/* provide a way to let loader know where */ 

/* root and swap can be found */ 
#define p_R0OTTAG 0x01 

#define P_SWAPTAG 0x02 

/* disk slice table in memory */ 
struct mpartit [ /* partition table */ 

uint strk; /* start track ff */ 

uintnsecs; /* # of logical sectors */ 

/* available to user */ 
I; 

If a volume home block is valid, magic is equal to VHBMAGIC 
and the 32-bit sum of the volume home block's bytes of 
OxFFFFFFFF (-1); chksum is the adjustment that makes the 
sum come out right. 
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Dsk describes the pecularities of the disk, including deliberate 
deviations from the system standard. Dsk.flags can be: 

EXCHANGEABLE 

If on, the disk is a floppy or removable hard disk car- 
tridge. If off, the disk is a fixed disk. 

Partab divides the disk into slices (partitions). 

Resmap describes the files that share Slice with the volume 
home block. Provision is made for eight such files, but only 
four have been assigned slots in resmap. Each resmap entry 
gives the starting location (logical block number) and length 
(logical blocks). A length of zero indicates that the file is not 
provided. The first five entries in resmap describe: 

1. The loader. When the system is reset or turned on, the 
boot prom loads the loader into the loader address and 
jumps execution to it. The function of the loader is to 
search for and load a program that will boot the system. 

On the 6000/50, the loader searches the tape drive, then 

the SCSI disk, in that order. _^ 

On each device, the loader first checks for a standalone 
program. If the disk lacks a standalone program, the 
loader checks for a System V kernel, which must be a 
6000/50 executable object file called /unix in the file sys- 
tem in slice 1. When the loader locates an appropriate 
program, it loads the program it found into address 
0x10000 and executes it. If no device contains an 
appropriate file, the loader continues searching until an 
appropriate tape or disk is inserted. 

2. The dump area. After Reset or Suicide, the boot prom 
dumps the contents of physical memory, until it runs out 
of room in the dump area. 

3. A bootable program, usually a diagnostic. This is the pro- 
gram the loader considers a substitute for the /unix file. 
The program must be in a.ouf(4) format with magic 
number 407 or be a simple memory image. f~\ 

If the fifth entry in resmap has a zero address but a 
nonzero length, the loader looks at the beginning of slize 
1 for the program. 
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Slice is called the Reserved Area. Only the volume home 
block and the files described by resmap can be in the 

,,— Reserved Area. A formatted disk used by a working system 

( ) would have at least one more slice. 

Ioctl system calls use the following structure. 

struct gd ioctl j 

ushort status; /* status */ 

struct gdswprt params; /* description of the disk */ 

struct gdswprt2 params2; /* more description of the */ 

/* disk */ 
short ctrltyp; /* the type of disk */ 

/* controller */ 



short 


driveno; 




uint 


totalblks 


/* total blocks available */ 
/* for use */ 



U 

Totalblks is less than cylinders * heads * sectors per track for 
SCSI disks, due to the tracks allocated for SCSI overhead. 

Status is the bitwise OR of the following constants. 

OPENED 

Indicates an attempt has been made to read the VHB. 
Set when the first open is performed for any slice on this 
disk; cleared when the drive goes off line. 

CT_FMT 

A valid VHB has been read for this disk. 

READY 

The disk controller has signalled that the disk is ready. 

WRPROT 

Write protect status; set if the media is write protected. 
This flag is set after each transfer. 

WINCH 

Set if the drive is a Winchester. 

EXCH 

Set if the drive accepts exchangeable media (floppy 
drive). 

Params is a gdswprt structure, the same type used in the 
volume header block. 
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Ctrltyp is equal to: 

GD_WD1010 

"for Western Digital 1010 ST506 controller. 

GD_NEC 

for NEC 765 floppy controller. 

GD_WD2797 

"for Western Digital 2797 floppy disk controller. 

GD_RAMDISK 

for RAM disk emulator. 

GD_SCSI 

for WD33C93 SCSI controller. 

System V understands the following disk ioctl calls: 

ioctl(fd, GDIOCTYPE, 0) 

Returns GDIOC if fd is a file descriptor for a disk special 
file. 

ioctl(fd, GDGETA, gdctl_ptr) 

Gdctfjptr is a pointer to a gdioctl structure. Ioctl fills the 
structure with information about the disk. 

ioctl(fd, GDSETA, gdctl_ptr) 

Gdctl_ptr is a pointer to a gdioctl structure. Ioctl passes 
the description of the disk to the disk driver. This is pri- 
marily meant for reading disks created by other kinds of 
computers. 

ioctl(fd, GDFORMAT, ptr) 

Ptr points to formatting information. The disk driver for- 
mats a track. 

ioctl(FD, GDDISMNT) 

Ioctl informs the driver that the user intends to remove 
the disk from the drive. When this system call success- 
fully returns, the driver has flushed all data in the buffer 
cache and waited for all queued transfers to complete. 
The last transfer is to write out the volume home block. 
Once this call returns, the drive is inaccessible until a new 
disk is inserted. 

ioctl(fd, GDRETRY) 

Disable/enable error retry. If the argument is 0, error 
retry is enabled; otherwise error retry is disabled. 
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SEE ALSO 

mknod(iM), 

ioctl(2) in the Programmer's Reference Manual. 
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NAME 

drivers - loadable device drivers 

DESCRIPTION 

(_) A loadable driver is equivalent to a fixed, linked-in device 

driver. It has access to all kernel subroutines and global data. 
After it is loaded, it is effectively part of the running kernel. 

For a device driver to be loadable by Iddrv^M), an entry for 
the device must be made in the master file /etc/master. 

Differences between loadable and ordinary drivers involve their 
driver ID, init routine, release routine, and interrupt processing. 

Init Routines 

Loadable drivers may have an init routine that is executed 
when the driver is bound, and a release routine that is exe- 
cuted when the driver is unbound (see /do*/v(1M) for a 
description of driver allocation and bind operations). Init rou- 
tines check for the existence of hardware, initialize the 
hardware, put the interrupt service routine for the hardware 
into the interrupt chain, and do other similar tasks. 

j Release Routines 

Release routines make sure the device or driver is idle, turn off 
the device, take the interrupt service routine out of the inter- 
rupt chain, and perform similar tasks. A typical action for a 
release routine to take when the device is not idle is to set an 
error code in u.u_error and return. If the device is 
guaranteed to become idle in a limited amount of time, the 
routine may do a sleep() or delay (). 

Interrupt Routines 

Expansion boards may reside on the AT bus or the Mbus. 
Boards on the AT bus may use any of the AT interrupts, num- 
bered through 15. Boards on the Mbus use interrupts num- 
bered 16 through 23. The hardware allows only one device 
per interrupt. See the U 6000 Series Technical Reference 
Manual for interrupts used by the base hardware and Unisys 
options. 

L. ) 
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When an interrupt occurs, the routine associated with that 
interrupt is executed. If the routine returns zero, a "spurious 
interrupt" message is logged in /usr/adm/unix.log. 

It is the responsibility of the interrupt routine for a device to 
return if it is called with no interrupt outstanding on its dev- 
ice and return non-zero and clear the interrupt if one does not 
exist for its device. 

The routines sef_yec() and resef_yec() are provided to add 
and delete interrupt service routines from the interrupt chain 
associated with a specific interrupt. The routines setjsplQ 
and resef_sp/() are provided to add and delete drivers from 
the spl structures so that the spl functions are aware of the 
new interrupt. Sef_sp/() assigns an spl level (a number 
between and 15) to the device. Standard spl levels for vari- 
ous devices (disk, tape, serial, network, and so forth) are 
defined in spl.h and should be used whenever possible. 
Assigning an improper spl level to a device can cause 
unpredictable and sometimes fatal results. Set_spl() also 
enables the interrupt, if it has not yet been enabled by 
another driver. 

Driver ID 

All drivers have a driver ID. Preloaded drivers have a driver ID 
of 0. Loaded drivers are given an ID when they allocate virtual 
space. The driver ID is automatically set when the driver is 
linked. The ID should never be modified by the driver itself; 
the ID is used to identify the driver to the system when mak- 
ing certain requests. 

FILES 

/etc/master 



SEE ALSO 

config(1M), lddrv(1M). 
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NAME 

enet - Ethernet interface and control 
DESCRIPTION 

The Ethernet interface defines a message interface to an Eth- 
ernet driver implemented under streams. This stream pro- 
vides a mechanism by which messages may be passed to the 
Ethernet driver from the consumer and vice versa. 

The Ethernet driver is a data link layer service. It is based on 
the definitions of the IEEE-802.3/Ethernet standard. 
The stream message types that are used to communicate 
between the consumer and the Ethernet driver have the fol- 
lowing format: 

• An M_PROTO message block possibly followed by one or 
more M_DATA message blocks. The M_PROTO message 
block contains the service primitive types and the relevant 
arguments associated with the primitives. The M_DATA 
blocks contain any consumer data associated with the 
service primitive. 

• An M_PCPROTO message block containing the service 
primitive type and all relevant arguments associated with 
the primitive. 

The Ethernet interface consists of two phases of communica- 
tion: initialization/deinitialization and data transfer. The follow- 
ing describes the format of the initialization or de-initialization 
primitives between the consumer and Ethernet driver. 

Consumer Originated Primitives 

DL_INFO_REQ 

Get Ethernet protocol parameter sizes. This primitive 
requests the Ethernet driver to return the size of all 
relevant parameters and the current state of the Ethernet 
driver. The format of the message is one M_PCPROTO 
message block. 

struct DL_info_req j 

long PRIM_type; /* always DL_INFO REQ */ 

1; 

Return: Acknowledgment of the primitive via the 
DL_INFO_ACK primitive. 
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Error: These errors are indicated via the 
DL_ERROR_ACK primitive. The allowable errors 
are as follows: »-»-.» 

DLSYSERR 6000/50 system error % — y 

DL_BIND_REQ 

Bind protocol address request. This primitive requests 
that the Ethernet driver bind a service access point to the 
stream and return the link layer address associated with 
the stream. The format of the message is one M_PROTO 
message block. 

struct DL_bind_req 1 

long PRlM_type; /* always DL_BIND_REQ */ 

long LLC_sap; /* the LSAP selector */ 

long GR0WTH_field[2]; /* 802.2 lie type 2 */ 
/* fields */ 

1; 

Return: Acknowledgment of the primitive via the 

DL_BIND_ACK primitive. ( 

Error: These errors are indicated via the 
DL_ERROR_ACK primitive. The allowable errors 
are as follows: 

DLBADSAP bad LSAP selector 

DLACCES inproper permissions 

DLOUTSTATE Link layer interface 

out of state 
DLSYSERR 6000/50 system error 

DL_UNBIND_REQ 

Unbind protocol address request. This primitive requests 
that the Ethernet driver unbind the protocol address asso- 
ciated with the stream and deactivate the stream. The 
format of the message is one M_PROTO message block. 

struct DL_unbind_req i /*-\ 

long PRlM_type; /* always DL_UNBIND_REQ */ \_J 

1; 

Return: Acknowledgment of the primitive via the 
DL_OK_ACK primitive. 
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Error: These errors are indicated via the 
DL_ERROR_ACK primitive. The allowable errors 
are as follows: 

DLOUTSTATE Link layer interface 

out of state 
DLSYSERR 6000/50 system error 

Ethernet Driver Originated Primitives 
DL_INFO_ACK 

Protocol information acknowledgment. This primitive indi- 
cates to the consumer any relevant Ethernet driver depen- 
dent information. The format of this message is one 
M_PROTO message block. 

struct DL_info_ack { 



long 


PR!H_type; 


/* always DL_INFO_ACK */ 


long 


SDUjnax; 


/* max lsdu size */ 


long 


SDUjnin; 


/* rofn lsdu size */ 


long 


ADDR_length; 


/* LSAP address length */ 
/* in bytes */ 


long 


SUBNET_type; 


/* subnet type */ 


long 


SERV_class; 


/* service class */ 


long 


CURRENT.state; 


/* link layer state */ 



long GR0WTH_fie1d[2]; /* 802.2 LLC2 fields */ 

!; 

The low order t6 bits of CURRENT_state contain the 
driver state as described below (DL_UNBND, DL_IDLE). 
The high order 16 bits contain interface flags, which are 
defined in net/if.h. 

DL_BIND_ACK 

Protocol bind acknowledgment. This primitive indicates to 
the consumer that the special link layer address has been 
bound to the stream and that the stream associated with 
the specified link layer address has been actived. The for- 
mat of the message is one M_PROTO message block. 

struct DL_bind_ack \ 

long PRIH_type; /* always DL_BIND_ACK */ 

long LLC_sap; /* lsap selector */ 

long ADORJength; /* LSAP address length */ 
/* in bytes */ 
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long ADDR_offset; /* LSAP address offset */ 

/* in the message */ 
long GROWTH_f ield[2];/* 802.2 LLC2 fields */ 

!; 

DL_ERROR_ACK 

Error acknowledgment. This primitive indicates to the 
cbnsumer that a error has ocurred in the last consumer 
originated primitive. It indicates to the consumer that no 
action was taken on the primitive that caused the error. 
The format of the message is one M_PCPROTO message 
block. 

struct DL_error_ack { 

long PRlM_type; /* always DL_ERROR_ACK */ 

long ERROR_prim; /* primitive in error */ 

long LLC_error; /* LLC error code */ 

long UN I X_err or; /* error code */ 

J; 

DL_OK_ACK 

Success acknowledgment. This primitive indicates to the 
consumer that the previous consumer originated primitive 
was received successfully by the Ethernet driver. The for- 
mat of the message is one M_PCPROTO message block. 

struct DL_ok_ack J 

long PRIM_type; /* always DL_0K_ACK */ 
long CORRECT_prim; /* correct primitive */ 

I; 

The following describes the format of the data transfer primi- 
tives between the consumer and Ethernet driver. 

Consumer Originated Primitives: 

DL_UNITDATA_REQ 

Unitdata send request. This primitive requests that the 
Ethernet driver send the specified datagram to the speci- 
fied destination. The format of this message is one 
M_PROTO message block followed by one or more 
M_DATA message blocks. 

struct DL_unitdata_req { 

long PRIM.type; /* always DL_UN!TDATA_REQ */ 

long RAJength; /* dest LSAP addr length */ 
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long RA_offset; /* dest LSAP addr offset */ 

long SERV_class; /* service class */ 
long FILLERJield; /* 802.2 LLC2 field */ 



Ethernet Driver Originated Primitives: 

DL_UNITDATA_IND 

Unitdata receive indication. This primitive indicates to the 
consumer that a datagram has been received from the 
specified remote address. The format of this message is 
one M_PROTO stream message block followed by one or 
more M DATA blocks. 



struct DL_unitdata_ind { 
long PRlM_type; 



/* always DLJJNITDATAJND */ 



long 


RA_1 ength; 


/* dest LSAP address */ 
/* length in bytes */ 


long 


RA_offsot; 


/* dest offset LSAP into */ 
/* message */ 


long 


LA_1 ength; 


/* src LSAP address length */ 
/* in bytes */ 


long 


LA.offset; 


/* src offset LSAP into */ 
/* message */ 


long 


SERV_class; 


/* service class */ 



!; 

DLJJDERRORJND 

Unitdata error indication. This indicates to the consumer 
that a datagram with the specified remote address pro- 
duced an error. The format of this message is one 
M_PROTO message block. 



/* always DLJJDERRORJND */ 

/* dest LSAP address length */ 

/* in bytes */ 

/* dest LSAP offset into msg */ 

/* in bytes */ 

/* service class */ 

/* error type */ 



struct DL_uderror_ind J 


long 


PRIM_type; 


long 


RAJ ength; 


long 


RA_offset; 


long 


SERV_class; 


long 


ERROR Jype; 



!; 



The definitions of consumer primitives are as follows: 



UP-13529 



Page 5 



ENET(7) 



DL_lNFO_REQ 



/* data link layer protocol parameter */ 
/* sizes */ 



DL_BIND_REQ 1 /* bind protocol address request */ 

DL_UNBIND_REQ 2 /* unbind protocol address request */ 
DL_UNITDATA_REQ 7 /* unit_data send request */ 

The definitions of Ethernet primitives are as follows: 



3 /* protocol information acknowledgement */ 

H /* protocol bind acknowledgement */ 

5 /* error acknowledgement */ 

6 /* success acknowledgement */ 



OL_lNFO_ACK 

DL_B1ND_ACK 

DL_ERROR_ACK 

DL_OK_ACK 

DLJJNITDATAJND 8 /* unitdata receive indication */ 

DL_UDERROR_IND 9 /* unitdata receive indication */ 

The primitive non-fatal error return codes are described as fol- 
lows: 



DLBADSAP 
DLACCES 
DLOUTSTATE 
DLSYSERR 



/* bad LSAP selector */ 

/* inproper permissions */ 

/* Link layer interface out of state */ 

/* 6000/50 system error */ 



Subnetwork types are: 

DL_CSMACD /* CSMA/CD network (802.3) */ 

DL_TPB 1 /* Token Passing Bus (802.4) */ 

DL_TPR 2 /* Token Ring Bus (802.5) */ 

DLJCTRO 3 /* Metro Net (802.6) */ 

DL_ETHER 4 /* ETHERNET bus */ 

There are two kinds of service classes for the data link layer. 
The Ethernet driver is a no-service class. 

DL_N0SERV /* No service class */ 
DL_CLASSES 1 /* Has a service class */ 

The current state of the Ethernet driver is defined as follows: 

DLJJNBNO /* LL not bound */ 

DL_WACK_B 1 /* LL waiting for bind ack */ 

DL_WACK_U 2 /* LL waiting for unbind ack */ 

DLJDLE 3 /* LL is active */ 

Ioctls 

Five ioctls are supported by the Ethernet driver. When these 
ioctls are issued by the user level, an MJOCTL message and 
the relevant parameters are generated by the stream head 
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and sent downstream. 

The format of these ioctls is as follows: 

ioctl(enet, I_STR, &loc) 

I_STR contructs a MJOCTL message from the data pointed to 
by &ioc and sends that message downstream. For this 
request, the ioctl blocks until the system responds with either 
an MJOCACK (positive acknowledgement) or MJOCNACK 
(negative acknowledgement). 

To send these ioctls, ioc must point to a structure of the fol- 
lowing form: 



strm 


ct str ioctl \ 






int ic_cmd; 


/* command */ 




int ic_timout; 


/* timeout value */ 




int ic_1en; 


/* length of data */ 




char *ic_dp; 


/* pointer to data */ 


u 







For selecting the hardware for the ethernet interface, each 
parameter in the structure of strioctl may be set as follows : 

ioc.lc_cmd = IFJJNITSEL; 
Ioc.icjlmout = 0; 
ioc.icjen = sizeof(int); 
ioc.ic_dp = (char *) &unit; 

where unit is the selected unit number, or 1 to select the 
first or second Ethernet board. 

For getting the Ethernet address from the hardware, each 
parameter in the structure of strioctl may be set as follows : 

ioc.ic_crnd = SIOCGENADDR; 
ioc.ictimout = 0; 
ioc.icjen = 0; 
ioc.ic_dp = buf; 

where buf is an array of NADDRLEN(6) bytes. When the ioctl 
returns, buf has been filled with the Ethernet address. 



\^J For reading Ethernet statistics, the strioctl fields are set as fol- 

lows: 

ioc.ic_cmd = SIOCGENPSTATS; 
ioc.icjimout = 0; 
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ioo.icjen = 0; 
ioc.ic_dp = &enpstat; 

where enpstat is a struct enpstats, defined in if_enp.h. 

For getting the interface flags, set: 

loc.lc_cmd = SIOCGIFFLAGS; 
ioc.icjimout = 0; 
ioc.ic_len = sizeof(struct ifreq); 
loc.ic_dp = &ifreq; 

For setting the interface flags, set: 

ioc.ic_cmd = SIOCSIFFLAGS; 
Ioc.icjimout = 0; 
ioc.icjen = sizeof(struct ifreq); 
ioc.ic_dp = &ifreq; 

where Ifreq is a structure defined in net/if.h. The flags are 
returned in ifreq.ifr_flags. 

FILES 

/dev/enet 

/dev/enet2 

/usr/include/sys/tihdr.h 

/usr/include/sys/stropts.h 

/usr/include/sys/stream.h 

/usr/include/sys/socket.h 

/usr/inc.ude/net/if.h 

/usr/include/netinet/if_enp.h 

/usr/include/netinet/if_ether.h 

/usr/include/sys/comm.h 

SEE ALSO 

streamio(7) 



Page 8 UP-13529 



1 



ERR(7) 



NAME 

err - error-logging interface 

r\ DESCRIPTION 

Minor device of the err driver is the interface between a pro- 
cess and the system's error- record collection routines. The 
driver may be opened only for reading by a single process 
with super-user permissions. Each read causes an entire error 
record to be retrieved and removed; the record is truncated if 
the read request is for less than the record's length. 

FILES 

/dev/error special file 

SEE ALSO 

errdemon(IM). 
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NAME 

fd - floppy disk (diskette) 

DESCRIPTION 

The 6000/50 supports up to two diskette drives. The diskette 
driver provides access to diskettes as both block and charac- 
ter devices. The minor device number for diskette devices is 
14 (OxOE). 

Diskettes must be formatted with 512 bytes per sector with 
MFM encoding by the /v(1) program. Diskettes may be either 
single-sided or double-sided double-density, or double-sided 
high density. The 6000/50 does not support single-density 
diskettes. Support is provided for 5.25" high density and dou- 
ble density drives, and 2.5" high density and double density 
drives. At system boot time, the equipment byte (0x14) in 
CMOS RAM is read to determine what drive types are 
installed. 

The device file names associated with diskette drives are in 
one of two formats. The 6000/50 format is similar to fixed disk 
layout and includes the 6000/50 volume home block (VHB). 
The second format is compatible with the standard 80386 
UNIX port; cylinder may be reserved for bootable tracks. 

The 6000/50 compatible format is as follows: 

/dev/(r)dsk/ced#s# 

where r, if present, indicates a raw (character) interface to the 
diskette, d# is the drive number and can be or 1, and s# is 
the slice number (# is between and 7 hex). 

The standard 80386 UNIX-compatible format is as follows: 

/dev/(r)dsk/fxfdq]n[d][t] 

where the initial d or q selects double or quad density, x is 
or 1, n is 8, 9, or 15, the second d indicates a double-sided 
diskette, and t indicates that the whole diskette is used 
(including the boot track). 

Using this format, the following device names are mapped to 
the following diskette slices for 5.25" drives, where n can be 
or 1: 

high density drive double density drive slice 
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fnq15d 


fndqd 


fnd9dt 


fnd9t 


fnd9d 


fnd9 


fnd8dt 


fnd8dt 


fnd8d 


fnd8d 


fnd8t 


fnd8t 


fnd8 


fnd8 



8 

9 

10 

11 

12 

13 

14 

15 

The following device names are mapped to the following 
diskette slices for 3.5" drives, where n can be or 1: 

high density drive double density drive slice 

8 

9 

10 

11 

12 

13 

14 

15 

SEE ALSO 

iv(1) in the User's Reference Manual. 

NOTE 

The standard 6000/50 release configures the first drive as a 
high density drive and the second drive as a double density 
drive. 



fnq18dt 


fnd9dt 


fnq18d 


fnd9d 


fnd9dt 


fnd9dt 


fnd9d 


fnd9d 


fnd9dt 


fnd9dt 


fnd9d 


fnd9d 


fnd9dt 


fnd9dt 


fnd9d 


fnd9d 
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NAME 

log - interface to STREAMS error logging and event tracing 

DESCRIPTION 

Log is a STREAMS software device driver that provides an 
interface for the STREAMS error logging and event tracing 
processes [sfre/r(1M) and strace (MA)]. Log presents two 
separate interfaces: a function call interface in the kernel 
through which STREAMS drivers and modules submit log mes- 
sages; and a subset of ioctl(2) system calls and STREAMS 
messages for interaction with a user level error logger, a trace 
logger, or processes that need to submit their own log mes- 
sages. 

Kernel Interface 

Log messages are generated within the kernel by calls to the 
function strlog: 

strlog(mid, sid, level, flags, fmt, argl, ...) 

6hort mid, sid; 

char level; 

ushort flags; 

char *fmt; 

unsigned argl; 

Required definitions are contained in <sys/strlog.h> and 
<sys/log.h>. Mid is the STREAMS module ID number for 
the module or driver submitting the log message. Sid is an 
internal sub-ID number usually used to identify a particular 
minor device of a driver. Level is a tracing level that allows for 
selective screening out of low priority messages from the 
tracer. Flags are any combination of SL_ERROR (the mes- 
sage is for the error logger), SL_TRACE (the message is for 
the tracer), SL_FATAL (advisory notification of a fatal error), 
and SL_NOTIFY (request that a copy of the message be 
mailed to the system administrator). Fmt is a printf (3S) style 
format string, except that %s, %e, %E, %g, and %G conver- 
sion specifications are not handled. Up to NLOGARGS 
(currently 3) numeric or character arguments can be provided. 

User Interface 

Log is opened via the clone interface, /dev/log. Each open of 
/dev/log obtains a separate stream to log. In order to receive 
log messages, a process must first notify log whether it is an 
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error logger or trace logger via a STREAMS I_STR ioctl call 
(see below). For the error logger, the I_STR ioctl has an 
ic_cmd field of I_ERRLOG, with no accompanying data. For 
the trace logger, the ioctl has an ic_cmd field of I_TRCLOG, 
and must be accompanied by a data buffer containing an 
array of one or more . struct trace Jds elements. Each 
tracejds structure specifies an mid, sid, and level from which 
message will be accepted. Strlog will accept messages whose 
mid and sid exactly match those in the tracejds structure, 
and whose level is less than or equal to the level given in the 
tracejds structure. A value of -1 in any of the fields of the 
tracejds structure indicates that any value is accepted for 
that field. 

At most one trace logger and one error logger can be active 
at a time. Once the logger process has identified itself via the 
ioctl call, tog will begin sending up messages subject to the 
restrictions noted above. These messages are obtained via 
the gefmsg(2) system call. The control part of this message 
contains a logjctl structure, which specifies the mid, sid, level, 
flags, time in licks since boot that the message was submit- 
ted, the corresponding time in seconds since January 1, 1970, 
and a sequence number. The time in seconds since 1970 is 
provided so that the date and time of the message can be 
easily computed, and the time in ticks since boot is provided 
so that the relative timing of log messages can be determined. 

Different sequence numbers are maintained for the error and 
trace logging streams, and are provided so that gaps in the 
sequence of messages can be determined (during times of 
high message traffic some messages may not be delivered by 
the logger to avoid hogging system resources). The data part 
of the message contains the unexpanded text of the format 
string (null terminated), followed by NLOGARGS words for the 
arguments to the format string, aligned on the first word 
boundary following the format string. 

A process may also send a message of the same structure to 
log, even if it is not an error or trace logger. The only fields of 
the log_ctl structure in the control part of the message that 
are accepted are the level and flags fields; all other fields are 
filled in by log before being forwarded to the appropriate 
logger. The data portion must contain a null terminated 
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format string, and any arguments (up to NLOGARGS) must be 
packed one word each, on the next word boundary following 
the end of the format string. 

Attempting to issue an IJTRCLOG or I_ERRLOG when a log- 
ging process of the given type already exists will result in the 
error ENXIO being returned. Similarly, ENXIO is returned for 
IJTRCLOG ioctls without any tracejds structures, or for any 
unrecognized I_STR ioctl calls. Incorrectly formatted log mes- 
sages sent to the driver by a user process are silently ignored 
(no error results). 

EXAMPLES 

Example of l_ERRLOG notification. 

struct strioctl ioc; 

foc.ic_cmd = I_ERRLOG; 

ioc.ic_timout - 0; /* default timeout (15 sees.) */ 

foc.icjen = 0; 

loc.fc_dp = NULL; 

ioctl (log, I_STR, &foc); 

Example of IJTRCLOG notification. 

struct trace_ids tid[2]; 

tid[0].ti_mid = 2; 
tid[0].ti_sid s 0; 
tid[0].ti_level = 1; 

t«d[1].ti_mid = 1002; 

tfd[1].ti_sid = -1; /* any sub- ID will be allowed */ 

tid[1].ti_level = -1; /* any level will be allowed */ 

ioc.ic_cmd = !_TRCL0G; 

ioc.ic_timout = 0; 

ioc.ic_1en = 2 * sizeof (struct trace_ids); 

ioc.ic_dp = (char *)tid; 

ioctl(log, I_STR, &ioc); 

Example of submitting a log message (no arguments). 
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struct strbuf ctl, dat; 
struct log_ctl ic; 

char "message = "Don't forget to pick up some milk on the „ 

way home"; ^ 

ctl.len = ctl.maxlen = sfzeof(lc); 
ctl.buf = (char *)&lc; 

dat. 1 en = dat.maxlen = strl en (message); 
dat.buf = message; 

1c. level = 0; 

1c. flags = SL_ERROR!SL_NOT!FY; 

putmsg(log, &ct1, &dat, 0); 

FILES 

/dev/log 

<sys/log.h> 

<sys/strlog.h> 

SEE ALSO 

strace(1M), strerr(1M), clone(7). 

intro(2), getmsg(2), putmsg{2) in the Programmer's Reference 

Manual. 

System V Operating System STREAMS Programmer's Guide. 
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NAME 

Ip - parallel printer interface 

DESCRIPTION 

Lp is an interface to the parallel printer channel. Bytes written 
are sent to the printer. Opening and closing produce page 
ejects. Unlike the serial interfaces [termio(7)], the Ip driver 
never prepends a carriage return to a new line (line feed). The 
Ip driver does have options to filter output, for the benefit of 
printers with special requirements. The driver also controls 
page format. Page format and filter options are controlled 
with /ocf/(2): 

/((include <sys/lprfo.h> 
ioctl(fildes, command, arg) 

where command is one of the following constants: 

LPRGET Get the current page format and put it in the 

Iprio structure pointed to by arg, 

LPRSET Set the current page format from the location 

pointed to by arg; this location is a structure 
of type Iprio, declared in the header file: 

struct Iprio j 
short ind; 
short col; 
short 1 ine; 

1; 

Arg should be declared as follows: 

struct Iprio *arg; 

Ind is the page indent in columns, initially 4. Col is the 
number of columns in a line, initially 132, Line is the number 
lines on a page, initially 66. A newline that extends over the 
end of a page is output as a formfeed. Lines longer than the 
line length minus the indent are truncated. LPRSOPTS Set 
the filter options from arg, which must be of type int. Arg 
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should be the logical or of one or more of the following con- 
stants, defined in the header file: 

Constant Value Meaning 

LPNOBS 4 No back space. Set this bit if the printer 

cannot properly interpret backspace char- 
acters. The driver uses carriage return to 
produce equivalent overstriking. 

LPRAW 8 Raw output. Set this bit if the driver must 

not edit output in any way. The driver 
ignores all other option bits. 

LPCAP 16 Capitals. This option supports printers 

with a "half-ASCII" character set. Lower- 
case is translated to uppercase. The fol- 
lowing special characters are translated: { 
to {, } to >; ' to -; | to I; " to "-. 

LPNOCR 32 No Carriage Return. This option supports 

printers that do not respond to a carriage 
return (character OD hexadecimal). Car- 
riage returns are changed to newlines. If 
No Newline is also set, carriage returns 
are changed to form feeds. 

LPNOFF 64 No Form Feed. This option supports 

printers that do not respond to a form 
feed (character OC hexadecimal). Form 
Feeds are changed to newlines. If No 
Newline is also set, form feeds are 
changed to carriage returns. 

LPNONL 128 No Newline. This option supports printers 
that do not respond to a newline (charac- 
ter OA hexadecimal). Newlines are 
changed to carriage returns. If No Car- 
riage Return is also set, newlines are 
changed to form feeds. 
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Setting all three of No Carriage Return, No 
New Line, and No Form Feed has the same 
effect as setting none of them. 

LPRGOPTS Return the current state of the filter options. 

Note that once set, options will remain intact through a close. 

FILES 

/dev/lp? 

SEE ALSO 

lpset(1M). 

Ipr(1) in the User's Reference Manual. 
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NAME 

mem, kmem - system memory image 

DESCRIPTION 

The file /dev/mem is a special file that is an image of the the 
system memory. It may be used, for example, to examine, 
and even to patch the system. 

Byte addresses in /dev/mem are interpreted as memory 
addresses. References to non-existent locations cause errors 
to be returned. 

Examining and patching device registers is likely to lead to 
unexpected results when read-only or write-only bits are 
present. 

The file /dev/kmem is the same as /dev/mem except that ker- 
nel virtual memory rather than physical memory is accessed. 

The per-process text and data for the current process begins 
at 0x00000000. For 410 executables, per process data begins 
on the next 4K boundary. For 413 executables, per-process 
data begins in the first page of the next page directory 
(0x400000 boundary), with an offset in that page of .etext. 
Non-valid pages cause errors to be returned. 

FILES 

/dev/mem 
/dev/kmem 

WARNING 

Some of /dev/kmem cannot be read because of write-only 
addresses or unequipped memory addresses. 
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NAME 

null - the null file 

DESCRIPTION 

Data written on the null special file, /dev/null, is discarded. 

Reads from a null special file always return bytes. 

FILES 

/dev/null 






r 

V 
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NAME 

prf - operating system profiler 

DESCRIPTION 

The special file /dev/prf provides access to activity information 
in the operating system. Writing the file loads the measure- 
ment facility with text addresses to be monitored. Reading 
the file returns these addresses and a set of counters indica- 
tive of activity between adjacent text addresses. 

The recording mechanism is driven by the system clock and 
samples the program counter at line frequency. Samples that 
catch the operating system are matched against the stored 
text addresses and increment corresponding counters for later 
processing. 

The file /dev/prf is a pseudo- device with no associated 
hardware, 

FILES 

/dev/prf 

SEE ALSO 

V^ 1 config(1M), profiler(iM). 



\ 
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NAME 

ramdisk, uramdisk - RAM disk drivers 

DESCRIPTION 

The RAM disk uses system memory as a disk device for stor- 
ing temporary or frequently accessed files to improve perfor- 
mance for I/O intensive applications. Due to the transient 
nature of this device (its contents are lost on power loss or 
when system software errors occur), and its effect of reducing 
memory for system operation, it should be used judiciously 
when valuable data is to be stored and when the system's 
memory is limited. 

The files /dev/dsk/cfdxsx and /dev/rdsk/cfdxsx refer to a dev- 
ice which appears to be a disk, but is actually some pages of 
system memory. This device is normally a loadable driver, so 
it must be loaded with lddrv(\M) before it can be used. 

There are two variants of the device: the device named "ram- 
disk" corresponds to devices cfdOsX and uses normal system 
memory. The device named "uramdisk" corresponds to dev- 
ices cfd2sX and uses the uncached portion of memory (if 
any). The uncached memory is slightly slower than normal 
system memory so is better suited for use as a RAM disk than 
as system memory. (There is also a device "tramdisk" 
corresponding to cfdlsX which is intended for use only by the 
System V installation procedure.) 

The RAM disk is used like any other disk device. Before being 
used, it should first be initialized with /V(1). 

For example, a description file named ramdisk.lM suitable for 
a RAM disk might be: 
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type RD 

name ramdisk 

cylinders 257 

heads 1 

sectors 8 

$ 

$ 

$ 



1 

129 $ 

$ 

$ 

The heads and sectors entries specify that each cylinder is 
4K, The cylinders entry specifies the number of 4K pages to 
be allocated for the RAM disk. In this example, 257 pages is 
one megabyte plus one page for the volume home block. The 
partition table is specified as for other disks [see /V(1)]. In this 
case, two partitions have been specified. The following com- 
mand would initialize the example RAM disk: 

iv -i /dev/rdsk/cfd2s0 ramdisk. 1M 

After being initialized, a file system can be made on the RAM 
disk by mkfs(1M) and it can then be mounted and used. A bit 
map is not necessary for a RAM disk, so the -O flag should be 
used: 

mkfs /dev/rdsk/cfd2sl -0 
mount /dev/dsk/cfd2s1 /mnt 

For the uncached RAM disk (device 2), it might make sense to 
use a partition as a swap device. (For the normal RAM disk, 
device 0, this would not make sense, since normal system 
memory would be more useful as real memory than as a swap 
device). If a partition of the RAM disk is to be used as a swap 
device, do not make a file system on it, but just add it as a 
swap device after initializing with iv: 

swap -a /dev/dsk/cfd2s2 

The data written to a RAM disk remains in the RAM disk, even 
if the disk is unmounted, until the ramdisk driver is unloaded 
or the system is rebooted. The memory pages allocated to 
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the RAM disk similarly are not released until one of those two 
events occurs. 

( ) SEE ALSO 

v - / mkfs(1M) mount(lM) disk(7). 

iv(1) in the User's Reference Manual. 

WARNINGS 

Only one of the RAM disk drivers {ramdisk, uramdisk) may be 
loaded at any one time. 

If there is uncached memory on the system, it is by default 
used for system buffers. A "uramdisk" device appropriates 
some of these buffers for use by the RAM disk. If you create 
a very large RAM disk, so that there is not enough uncached 
memory left for system buffers, system performance may 
degrade. 



\ sas ^' 
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NAME 

sa - devices administered by System Administration 

f'\ DESCRIPTION 

w The files in the directories /dev/SA (for block devices) and the 

/dev/rSA (for raw devices) are used by System Administration 
to access the devices on which it operates. For devices that 
support more than one partition (like disks) the /dev/(r)SA 
entry is linked to the partition that spans the entire device. 
Not all /dev/(r)SA entries are used by all System Administra- 
tion commands. 

FILES 

/dev/SA 
/dev/rSA 
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NAME 

scpa - SCP active mode interface 

^ SYNOPSIS 

v - #include <sys/scp.h> 

DESCRIPTION 

The scpa driver provides loading and unloading functions for 
the Serial Communications Processor (SCP) board when run- 
ning in active mode. The open of device /dev/scpa fails if no 
active SCP boards are present or if they are already loaded. 
The only allowable function after opening the scpa device is to 
issue an ioctl call to download to the SCP boards. 

Three tunable parameters are passed to the driver from the 
/etc/master file. These parameters are: 

P1 The base I/O address for the first three SCP boards, 
specified as the value of the six address bits defined by 
DIP switch SW1 switches 1 to 6, where ON = and OFF 
= 1 , with switch 6 corresponding to bit 0. 

/"% P2 The base AT Bus memory address to be mapped to SCP 

v_y shared memory. The 128K shared memory space of all 

active SCP boards is mapped contiguously, with the max- 
imum configuration of 5 boards requiring a 640K region. 
A value of causes the boards to be mapped to the 
upper end of the 16MB AT Bus memory space, so that if 
N is the number of active SCP boards, the base address 
of shared memory space would be: 

OxFEOOOO - N * (0x20000) 

An out-of-range address or an address that does not 
allow enough room for all active SCP boards causes the 
initialization to return with an error. 

P3 The starting SCP board number (in the range 1 to 5) that 
is to be used in active mode. Values of this parameter 
other than 1 assume that the passive SCP driver has been 

/ -~\ loaded and will continue to support the lower numbered 

K.J boards. 

A typical setting for the tunable parameters would be: 

0x10 o 1 

for default SCP I/O addresses 0x500, 0x900, and OxCOO, 
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mapping to the upper range of AT Bus memory, and all 
boards active. 

The following command is supported via ioctl: 

SCPATTACH 

Download to all active SCP boards (as specified 
by the third tunable parameter); arg must point 
to an area in the caller's space where the first 4 
bytes are a count of the number of bytes to be 
loaded. The actual data must follow the count 
immediately. The count bytes are copied to each 
active SCP with the last byte aligned to the last 
byte of each 128K shared memory region. After 
loading, each active SCP is reset and begins exe- 
cution at location F000:FFF0 in its memory. 

SEE ALSO 

master(4) in the Programmer's Reference Manual. 



(. 
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NAME 

scsi - SCSI busses and peripherals 

DESCRIPTION 

The 6000/50 has a main internal SCSI bus (SCSI hostbus 
number 0) and supports external SCSI busses (SCSI hostbus 
numbers 1, 2, and so forth). Each of these busses is con- 
trolled by a host SCSI controller (WD33C93). The controller's 
SCSI ID is set to 7. 

On each SCSI hostbus, there are at most 7 target SCSI dev- 
ices attached. Each of these target devices has a unique 
SCSI ID (TARGETID through 6) on each bus. 

Each target device can also have associated with it some 
optional configuration parameters [see scsicnfg (1M)]: 

PARITY If this parameter is specified, the target device 
supports parity on the SCSI bus. 

RESELECT This parameter specifies that the target device 
can disconnect from the SCSI bus while it is 
doing internal processing and reconnect to the 
bus when it is ready to continue sending or 
receiving data. 

SYNC If this parameter is specified, the target device 

uses synchronous protocol (as opposed to asyn- 
chronous protocol, the default). 

Each target SCSI device can support up to 8 attached drives. 
Each of these drives is assigned a unique logical unit number 
(LUN through 7). 

Note that for must currently available target SCSI peripherals, 
there is only one logical unit, LUN (0). The 6000/50 currently 
supports two types of SCSI devices: disk and tape. 
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NAME 

streamio - STREAMS ioctl commands 

SYNOPSIS 

#include <stropts.h> 

int iocti {fildes, command, arg) 

int fiides, command; 

DESCRIPTION 

STREAMS [see intro{2)] Ioctl commands are a subset of 
ioctl (2) system calls which perform a variety of control func- 
tions on streams. The arguments command and arg are 
passed to the file designated by fildes and are interpreted by 
the stream head. Certain combinations of these arguments 
may be passed to a module or driver in the stream. 

Fildes is an open file descriptor that refers to a stream. Com- 
mand determines the control function to be performed as 
described below. Arg represents additional information that is 
needed by this command. The type of arg depends upon the 
command, but it is generally an integer or a pointer to a 
command-specific data structure. 

Since these STREAMS commands are a subset of ioctl, they 
are subject to the errors described there. In addition to those 
errors, the call will fail with errno set to EINVAL, without pro- 
cessing a control function, if the stream referenced by fildes is 
linked below a multiplexor, or if command is not a valid value 
for a stream. 

Also, as described in ioctl, STREAMS modules and drivers can 
detect errors, In this case, the module or driver sends an 
error message to the stream head containing an error value. 
This causes subsequent system calls to fail with errno set to 
this value. 

COMMAND FUNCTIONS 

The following ioctl commands, with error values indicated, are 
applicable to all STREAMS files: 
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1_PUSH 

Pushes the module whose name is pointed to by arg onto 

the top of the current stream, just below the stream head. 

It then calls the open routine of the newly-pushed 

module. On failure, errno is set to one of the following 

values: 

[BNVAL] Invalid module name. 

[EFAULT] Arg points outside the allocated address 
space. 

[ENXIO] Open routine of new module failed. 

[ENXIO] Hangup received on fildes. 

I_POP 

Removes the module just below the stream head of the 
stream pointed to by fildes. Arg should be in an 
I_POP request. On failure, errno is set to one of the fol- 
lowing values: 

[BNVAL] No module present in the stream. 
[ENXIO] Hangup received on fildes. 

I_LOOK 

Retrieves the name of the module just below the stream 
head of the stream pointed to by fildes, and places it in 
a null terminated character string pointed at by arg. 
The buffer pointed to by arg should be at least 
FMNAMESZ+1 bytes long. A "#include 
<sys/conf.h>" declaration is required. On failure, 
errno is set to one of the following values: 

[EFAULT] Arg points outside the allocated address 
space. 

[EINVAL] No module present in stream. 

I_FLUSH 

This request flushes all input and/or output queues, 
depending on the value of arg. Legal arg values are: 

FLUSHR Flush read queues. 

FLUSHW Flush write queues. 

FLUSHRW Flush read and write queues. 



Page 2 UP-13529 



STREAM IO (7) 



/-"■ 



On failure, errno is set to one of the following values: 

[EAGAIN] Unable to allocate buffers for flush mes- 
sage. 

[EINVAL] Invalid arg value. 

[ENXIO] Hangup received on fildes. 

I_SETSIG 

Informs the stream head that the user wishes the kernel 
to issue the SIGPOLL signal [see signal (2) and sig- 
set(2)] when a particular event has occurred on the 
stream associated with fildes. I_SETSIG supports an 
asynchronous processing capability in STREAMS. The 
value of arg is a bitmask that specifies the events for 
which the user should be signaled. It is the bitwise-OR 
of any combination of the following constants: 

SJNPUT A non-priority message has arrived on a 
stream head read queue, and no other 
messages existed on that queue before 
this message was placed there. This is 
set even if the message is of zero length. 

S_HIPRI A priority message is present on the 

stream head read queue. This is set even 
if the message is of zero length. 

S_OUTPUT The write queue just below the stream 
head is no longer full. This notifies the 
user that there is room on the queue for 
sending (or writing) data downstream. 

S_MSG A STREAMS signal message that contains 

the SIGPOLL signal has reached the front 
of the stream head read queue. 

A user process may choose to be signaled only of prior- 
ity messages by setting the arg bitmask to the value 
SJHIPRI. 

Processes that wish to receive SIGPOLL signals must 
explicitly register to receive them using I_SETSIG. If 
several processes register to receive this signal for. the 
same event on the same Stream, each process will be 
signaled when the event occurs. 
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If the value of arg is zero, the calling process will be 
unregistered and will not receive further SIGPOLL sig- 
nals. On failure, errno is set to one of the following 
values: /""*' 

[EINVAL] Arg value is invalid or arg is zero and pro- *" 

cess is not registered to receive the SIG- 
POLL signal. 

[EAGAIN] Allocation of a data structure to store the 
signal request failed. 

I_GETSIG 

Returns the events for which the calling process is 
currently registered to be sent a SIGPOLL signal. The 
events are returned as a bitmask pointed to by arg, 
where the events are those specified in the description 
of I_SETSIG above. On failure, errno is set to one of 
the following values: 

[EINVAL] Process not registered to receive the SIG- 
POLL signal. 

[EFAULTJ Arg points outside the allocated address { 

space. 

I_F1ND 

This request compares the names of all modules 
currently present in the sfream to the name pointed to 
by arg, and returns 1 if the named module is present in 
the stream. It returns if the named module is not 
present. On failure, errno is set to one of the following 
values: 

[EFAULT] Arg points outside the allocated address 
space. 

[EINVAL] Arg does not contain a valid module 
name. 

I_PEEK 

This request allows a user to retrieve the information in __ 

the first message on the stream head read queue f \ 
without taking the message off the queue. Arg points % -^ 
to a strpeek structure which contains the following 
members: 
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struct strbuf 


ctlbuf; 


struct strbuf 


databuf; 


long 


flags; 



Ss — / The maxlen field in the ctlbuf and databuf strbuf struc- 

tures [see getmsg(2)] must be set to. the number of 
bytes of control information and/or data information, 
respectively, to retrieve. If the user sets flags to 
RS_HIPRI, I_PEEK will only look for a priority message 
on the stream head read queue. 

I_PEEK returns 1 if a message was retrieved, and 
returns if no message was found on the stream head 
read queue, or if the RS_HIPRI flag was set in flags 
and a priority message was not present on the stream 
head read queue. It does not wait for a message to 
arrive. On return, ctlbuf specifies information in the 
control buffer, databuf specifies information in the data 
buffer, and flags contains the value or RS_HIPRI. On 
failure, errno is set to the< following value: 

f""\ [EFAULT] Arg points, or the buffer area specified in 

* w/ ctlbuf or databuf is, outside the allocated 

address space. 

I_SRDOPT 

v Sets the read mode using the value of the argument 
arg. Legal arg values are: 

RNORM Byte-stream mode, the default. 

RMSGD Message-discard mode. 

RMSGN Message-nondiscard mode. 

Read modes are described in read (2), On failure, errno 
is set to the following value: 

[EINVAL] Arg is not one of the above legal values. 

I_GRDOPT 

Returns the current read mode setting in an int pointed 
f~'\ to by the argument arg. Read modes are described in 

% -~~ y ' read (2). On failure, errno is set to the following value: 

[EFAULT] Arg points outside the allocated address 
space. 
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I_NREAD 

Counts the number of data bytes in data blocks in the 
first message on the stream head read queue, and 
places this value in the location pointed to by arg. The 
return value for the command is the number of mes- 
sages on the stream head read queue. For example, if 
zero is returned in arg, but the ioctl return value is 
greater than zero, this indicates that a zero-length mes- 
sage is next on the queue. On failure, errno is set to 
the following value: 

[EFAULT] Arg points outside the allocated address 
space. 

I_FDINSERT 

Creates a message from user specified buffer(s), adds 
information about another stream and sends the mes- 
sage downstream. The message contains a control part 
and an optional data part. The data and control parts 
to be sent are distinguished by placement in separate 
buffers, as described below. 

Arg points to a strfdinsert structure which contains the 
following members: 



struct strbuf 


ctlbuf; 


struct strbuf 


databuf; 


long 


flags; 


int fd; 





int offset; 

The len field in the ctlbuf strbuf structure [see 

putmsg{2)] must be set to the size of a pointer plus the 

number of bytes of control information to be sent with 

the message. Fd specifies the file descriptor of the 

other stream and offset , which must be word-aligned, 

specifies the number of bytes beyond the beginning of 

the control buffer where I_FDINSERT will store a pointer 

to the fd stream's driver read queue structure. The len ^-^ 

field in the databuf strbuf structure must be set to the 

number of bytes of data information to be sent with the 

message or zero if no data part is to be sent. 

Flags specifies the type of message to be created. A 
non-priority message is created if flags is set to 0, and 
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a priority message is created if flags is set to RS_HIPRI. 
For non-priority messages, I_FDINSERT will block if the 
stream write queue is full due to internal flow control 
conditions. For priority messages, I_FDINSERT does 
not block on this condition. For non-priority messages, 
I_FDINSERT does not block when the write queue is full 
and 0_NDELAY is set. Instead, it fails and sets errno to 
EAGAIN. 

I_FDINSERT also blocks, unless prevented by lack of 
internal resources, waiting for the availability of mes- 
sage blocks in the stream, regardless of priority or 
whether 0_NDELAY has been specified. No partial 
message is sent. On failure, errno is set to one of the 
following values: 

[EAGAIN] A non-priority message was specified, the 
0_NDELAY flag is set, and the stream 
write queue is full due to internal flow 
control conditions. 

[EAGAIN] Buffers could not be allocated for the 
message that was to be created. 

[EFAULT] Arg points outside the allocated address 
space, or the buffer area specified in 
ctlbuf or databuf is outside the allocated 
address space. 

[BNVAL] One of the following: fd in the strfdinsert 
structure is not a valid, open stream file 
descriptor; the size of a pointer plus 
offsef is greater than the len field for the 
buffer specified through ctlptr; offset 
does not specify a properly-aligned loca- 
tion in the data buffer; an undefined value 
is stored in flags. 

[ENXIO] Hangup received on fildes. 

[ERANGE] The len field for the buffer specified 
through databuf does not fall within the 
range specified by the maximum and 
minimum packet sizes of the topmost 
stream module, or the len field for the 
buffer specified through databuf is larger 
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than the maximum configured size of the 
data part of a message, or the ten field 
for the buffer specified through ctlbuf is 
larger than the maximum configured size 
of the control part of a message. 

I_STR Constructs an internal STREAMS ioctl message from 
the data pointed to by arg, and sends that message 
downstream. 

This mechanism is provided to send user ioctl requests 
to downstream modules and drivers. It allows informa- 
tion to be sent with the ioctl, and will return to the user 
any information sent upstream by the downstream reci- 
pient. I_STR blocks until the system responds with 
either a positive or negative acknowledgement mes- 
sage, or until the request "times out" after some period 
of time. If the request times out, it fails with ermo set 
to ETIME. 

At most, one I_STR can be active on a stream. Further 
I_STR calls will block until the active I_STR completes at 
the stream head . The default timeout interval for these 
requests is 15 seconds. The 0_NDELAY [see open (2)] 
flag has no effect on this call. 

To send requests downstream, arg must point to a 
strioctl structure which contains the following members: 

int ic_cmdj /* downstream command */ 
int ic_timout; /* ACK/MAK timeout */ 

int ic_1enj /* length of data arg */ 
char *ic_dp; /* ptr to data arg */ 

Ic_cmd is the internal ioctl command intended for a 
downstream module or driver and icjimout is the 
number of seconds (-1 = infinite, = use default, >0 
= as specified) an I_STR request will wait for ack- 
nowledgement before timing out. Icjen is the number 
of bytes in the data argument and ic_dp is a pointer to 
the data argument. The icjen field has two uses: on 
input, it contains the length of the data argument 
passed in, and on return from the command, it contains 
the number of bytes being returned to the user (the 
buffer pointed to by ic_dp should be large enough to 
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contain the maximum amount of data that any module 
or the driver in the stream can return), 

f~\ The stream head will convert the information pointed to 

K.J by the strioctl structure to an internal ioctl command 

message and send it downstream. On failure, errno is 

set to one of the following values: 

[EAGAIN] Unable to allocate buffers for the ioctl 
message. 

[EFAULT] Arg points, or the buffer area specified by 
ic_dp and icjen (separately for data sent 
and data reTurned) is, outside the allo- 
cated address space. 

[EINVAL] Icjen is less than or icjen is larger 
than the maximum configured size of the 
data part of a message or icjimout is 
less than-1. 

[ENXIO] Hangup received on fildes . 

[ETIME] A downstream ioctl timed out before ack- 

nowledgement was received. 

An I_STR can also fail while waiting for an acknowledge- 
ment if a message indicating an error or a hangup is 
received at the stream head. In addition, an error code 
can be returned in the positive or negative ack- 
nowledgement message, in the event the ioctl com- 
mand sent downstream fails. For these cases, I_STR 
will fail with errno set to the value in the message. 

I_SENDFD 

Requests the stream associated with fildes to send a 
message, containing a file pointer, to the sfream head 
at the other end of a stream pipe. The file pointer 
corresponds to arg, which must be an integer file 
descriptor. 

„-» x I_SENDFD converts arg into the corresponding system 

{^j file pointer. It allocates a message block and inserts 

the file pointer in the block. The user ID and group ID 
associated with the sending process are also inserted. 
This message is placed directly on the read queue [see 
intro(2)] of the stream head at the other end of the 
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stream pipe to which it is connected. On failure, errno 
is set to one of the following values: 

[EAGAIN] The sending stream is unable to allocate a 
message block to contain the file pointer. 

[EAGAIN] The read queue of the receiving stream 
head is full and cannot accept the mes- 
sage sent by I_SENDFD. 

[EBADF] Arg is not a valid, open file descriptor. 

[HNVAL] Fildes is not connected to a stream pipe. 

[ENXIO] Hangup received on fildes. 

I_RECVFD 

Retrieves the file descriptor associated with the mes- 
sage sent by an I_SENDFD ioctl over a stream pipe. 
Arg is a pointer to a data buffer large enough to hold 
an strrecvfd data structure containing the following 
members: 

int fd; 

unsigned short utd; 
unsigned short gfd; 
char fill[8]; 

Fd is an integer file descriptor. Uid and gid are the 
user ID and group ID, respectively, of the sending 
stream. 

If 0_NDELAY is not set [see open (2)], I_RECVFD will 
block until a message is present at the stream head. If 
0_NDELAY is set, I_RECVFD will fail with errno set to 
EAGAIN if no message is present at the stream head. 

If the message at the stream head is a message sent 
by an I_SENDFD, a new user file descriptor is allocated 
for the lile pointer contained in the message. The new 
file descriptor is placed in the fd field of the strrecvfd 
structure. The structure is copied into the user data 
buffer pointed to by arg. On failure, errno is set to one 



of the following values: 
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[EAGAIN] A message was not present at the stream 
head read queue, and the 0_NDELAY 
flag is set. 

[EBADMSG] The message at the stream head read 
queue was not a message containing a 
passed file descriptor. 

[EFAULT] Arg points outside the allocated address 
space. 

[EMFILE] NOFILES file descriptors are currently 
open. 

[ENXIO] Hangup received on fildes. 

The following two commands are used for connecting and 
disconnecting multiplexed STREAMS configurations. 

IJJNK 

Connects two streams, where f/7des is the file descriptor 
of the stream connected to the multiplexing driver, and 
arg is the file descriptor of the stream connected to 
another driver. The stream designated by arg gets con- 
nected below the multiplexing driver. IJJNK requires the 
multiplexing driver to send an acknowledgement message 
to the stream head regarding the linking operation. This 
call returns a multiplexor ID number (an identifier used to 
disconnect the multiplexor, see I_UNLINK) on success, 
and a -1 on failure. On failure, errno is set to one of the 
following values: 

[ENXIO] Hangup received on fildes. 

[ETIME] Time out before acknowledgement message 

was received at stream head. 

[EAGAIN] Unable to allocate STREAMS storage to per- 
form the IJJNK. 

[EBADF] Arg is not a valid, open file descriptor. 

[EINVAL] Fildes stream does not support multiplex- 
ing. 

[EINVAL] Arg is not a stream, or is already linked 
under a multiplexor. 
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[EINVAL] The specified link operation would cause a 
"cycle" in the resulting configuration; that 
is, if a given stream head is linked into a f- 

multiplexing configuration in more than one \_ 

place. 

An I_LINK can also fail while waiting for the multiplexing 
driver to acknowledge the link request, if a message indi- 
cating an error or a hangup is received at the stream 
head of fildes. In addition, an error code can be returned 
in the positive or negative acknowledgement message. 
For these cases, I_LINK will fail with errno set to the value 
in the message. 

IJJNLINK 

Disconnects the two streams specified by fildes and 
arg. Fildes is the file descriptor of the stream con- 
nected to the multiplexing driver. Arg is the multiplexor 
ID number that was returned by the ioctl IJJNK com- 
mand when a stream was linked below the multiplexing 
driver. If arg is -1, then all Streams which were linked jr-* 

to fildes are disconnected. As in IJJNK, this command w 

requires the multiplexing driver to acknowledge the 
unlink. On failure, errno is set to one of the following 
values: 

[ENXIO] Hangup received on fildes. 

[ETIME] Time out before acknowledgement mes- 

sage was received at sfream head. 

[EAGAIN] Unable to allocate buffers for the ack- 
nowledgement message. 

[EINVAL] Invalid multiplexor ID number. 

An I_UNLINK can also fail while waiting for the multi- 
plexing driver to acknowledge the link request, if a mes- 
sage indicating an error or a hangup is received at the 
sfream head of fildes. In addition, an error code can 
be returned in the positive or negative acknowledge- f ") 

ment message. For these cases, IJJNLINK will fail with x — / 

errno set to the value in the message. 

SEE ALSO 

close(2), fcntl(2), intro(2), ioctl(2), open(2), read(2), getmsg(2), 
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poll (2), putmsg(2), signal (2), sigset(2), write (2) in the 
Programmer's Reference Manual, 

System V Operating System STREAMS Programmer's Guide. 
System V Operating System STREAMS Primer. 

DIAGNOSTICS 

Unless specified otherwise above, the return value from ioctl is 
upon success and -1 upon failure with errno set as indi- 
cated. 



f \ 
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NAME 

sxt - pseudo-device driver 

*~\ DESCRIPTION 

w' The special file /dev/sxt is a pseudo-device driver that inter- 

poses a discipline between the standard fry line disciplines and 
a real device driver. The standard disciplines manipulate vir- 
tual tty structures (channels) declared by the /dev/sxt driver. 
/Dev/sxt acts as a discipline manipulating a real tty structure 
declared by a real device driver. The /dev/sxt driver is 
currently only used by the shl{\) command. 

Virtual ttys are named by i-nodes in the subdirectory /dev/sxt 
and are allocated in groups of up to eight. To allocate a 
group, a program should exclusively open a file with a name 
of the form /dev/sxt/??0 (channel 0) and then execute a 
SXTIOCLINK ioctl call to initiate the multiplexing. 

Only one channel, the controlling channel, can receive input 
from the keyboard at a time; others attempting to read will be 
blocked. 

There are two groups of ioctl(2) commands supported by sxt. 
The first group contains the standard ioctl commands 
described in termio(7), with the addition of the following: 

710CEXCL 

Set exclusive use mode: no further opens are permitted 
until the file has been closed. 

TIOCNXCL 

Reset exclusive use mode: further opens are once again 
permitted. 

The second group are commands to sxt itself. Some of these 
may only be executed on channel 0. 

SXTIOCLINK 

Allocate a channel group and multiplex the virtual ttys 
onto the real tty. The argument is the number of chan- 
^ nels to allocate. This command may only be executed on 

( ) channel 0. Possible errors include: 

EINVAL The argument is out of range. 

ENOTTY The command was not issued from a real tty. 
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ENXIO Linesw is not configured with sxt, 

EBUSY An SXTIOCLINK command has already been 

issued for this real tty. 

ENOMEM There is no system memory available for allo- 
cating the virtual tty structures. 

EBADF Channel was not opened before this call. 

SXTIOCSWTCH 

Set the controlling channel. Possible errors include: 

EINVAL An invalid channel number was given. 

EPERM The command was not executed from 
channel 0. 

SXTIOCWF 

Cause a channel to wait until it is the controlling chan- 
nel. This command will return the error EINVAL if an 
invalid channel number is given. 

SXTIOCUBLK 

Turn off the loblk control flag in the virtual tty of the 
indicated channel. The error EINVAL will be returned if 
an invalid number or channel is given. 

SXTIOCSTAT 

Get the status (blocked on input or output) of each 
channel and store in the sxtblock structure referenced 
by the argument. The error EFAULT will be returned if 
the structure cannot be written. 

SXTIOCTRACE 

Enable tracing. Tracing information is written to 
/dev/asm on the 6000/50. This command has no effect 
if tracing is not configured. 

SXTIOCNOTRACE 

Disable tracing. This command has no effect if tracing 
is not configured. 

FILES 

/dev/sxt/??[0-7] Virtual tty devices 

/usr/include/sys/sxt.h Driver specific definitions 

SEE ALSO 

termio(7). 
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shl(1), stty(1) in the User's Reference Manual, 

ioctl(2), open(2) in the Programmer's Reference Manual. 



f 
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NAME 

termio - general terminal interface 

DESCRIPTION 

All of the asynchronous communications ports use the same 
general interface, no matter what hardware is involved. The 
remainder of this section discusses the common features of 
this interface. 

When a terminal file is opened, it normally causes the process 
to wait until a connection is established. In practice, users' 
programs seldom open terminal files; they are opened by 
getty and become a user's standard input, output, and error 
files. The very first terminal file opened by the process group 
leader of a terminal file not already associated with a process 
group becomes the control terminal for that process group. 
The control terminal plays a special role in handling quit and 
interrupt signals, as discussed below. The control terminal is 
inherited by a child process during a fork (2). A process can 
break this association by changing its process group using 
sefpgrp(2). 

A terminal associated with one of these files ordinarily 
operates in full-duplex mode. Characters may be typed at 
any time, even while output is occurring, and are only lost 
when the system's character input buffers become completely 
full, which is rare, or when the user has accumulated the max- 
imum allowed number of input characters that have not yet 
been read by some program. Currently, this limit is 256 char- 
acters. When the input limit is reached, the buffer is flushed 
and all the saved characters are thrown away without notice. 

Normally, terminal input is processed in units of lines. A line is 
delimited by a new-line (ASCII LF) character, an end-of-file 
(ASCII EOT) character, or an end-of-line character. This 
means that a program attempting to read will be suspended 
until an entire line has been typed. Also, no matter how many 
characters are requested in the read call, at most one line will 
f~\ t be returned. It is not, however, necessary to read a whole line 
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at once; any number of characters may be requested in a 
read, even one, without losing information. 

During input, erase and kill processing is normally done. By 
default, the character generated by a BACK SPACE key 
(ASCII BS, Control- H on most terminals) erases the last char- 
acter typed, except that it will not erase beyond the beginning 
of the line. By default, the character "U (Control-U) kills 
(deletes) the entire input line, and optionally outputs a new- 
line character. Both these characters operate on a key-stroke 
basis, independently of any backspacing or tabbing that may 
have been done. Both the erase and kill characters may be 
entered literally by preceding them with the escape character 
(\). In this case the escape character is not read. The erase 
and kill characters may be changed. 

Certain characters have special functions on input. These 
functions and their default character values are summarized 
as follows: 

INTR (Control-C) generates an interrupt signal which is sent 
to all processes with the associated control terminal. 
Normally, each such process is forced to terminate, 
but arrangements may be made either to ignore the 
signal or to receive a trap to an agreed-upon location; 
see signal (2). 

QUIT (Control- j or ASCII FS) generates a quit signal. Its 
treatment is identical to the interrupt signal except 
that, unless a receiving process has made other 
arrangements, it will not only be terminated but a 
core image file (called core) will be created in the 
current working directory. 

SWTCH (Control-z or ASCII SUB) is used by the job control 
facility, shl, to change the current layer to the control 
layer. 

ERASE (Control-H or ASCII BS) erases the preceding charac- 
ter. It will not erase beyond the start of a line, as del- 
imited by a NL, EOF, or EOL character. 

KILL (@) deletes the entire line, as delimited by a NL, EOF, 
or EOL character. 
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EOF (Control-D or ASCII EOT) may be used to generate 
an end-of-file from a terminal. When received, all the 
characters waiting to be read are immediately passed 
to the program, without waiting for a new-line, and 
the EOF is discarded. Thus, if there are no charac- 
ters waiting, which is to say the EOF occurred at the 
beginning of a line, zero characters will be passed 
back, which is the standard end-of-file indication. 

NL (ASCII LF) is the normal line delimiter. It can not be 

changed or escaped. 

EOL (ASCII NUL) is an additional line delimiter; like NL. It 
is not normally used. 

EOL2 is another additional line delimiter. 

STOP (Control-s or ASCII DC3) can be used to temporarily 
suspend output. It is useful with CRT terminals to 
prevent output from disappearing before it can be 
read. While output is suspended, STOP characters 
are ignored and not read. 

START (Control-q or ASCII DC1) is used to resume output 
which has been suspended by a STOP character. 
While output is not suspended, START characters are 
ignored and not read. The start/stop characters can 
not be changed or escaped. 

The character values for INTR, QUIT, SWTCH, ERASE, KILL, 
EOF, and EOL may be changed to suit individual tastes. The 
ERASE, KILL, and EOF characters may be escaped by a 
preceding \ character, in which case no special function is 
done. 

When the carrier signal from the data-set drops, a hang-up 
signal is sent to all processes that have this terminal as the 
control terminal. Unless other arrangements have been made, 
this signal causes the processes to terminate. If the hang-up 
signal is ignored, any subsequent read returns with an end- 
of-file indication. Thus, programs that read a terminal and 
test for end-of-file can terminate appropriately when hung up 
on. 

When one or more characters are written, they are transmitted 
to the terminal as soon as previously-written characters have 
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finished typing. Input characters are echoed by putting them 
in the output queue as they arrive. If a process produces 
characters more rapidly than they can be typed, it will be 
suspended when its output queue exceeds some limit. When 
the queue has drained down to some threshold, the program 
is resumed. 

Several ioctl(2) system calls apply to terminal files. The pri- 
mary calls use the following structure, defined in <term!o.h>: 



^define 


NCC 


8 






struct 


termio J 










unsigned 


short 


c_iflag; 


/* input modes */ 




unsigned 


short 


c_oflag; 


/* output modes */ 




unsigned 


short 


c_cflag; 


/* control modes */ 




unsigned 


short 


c_lflag; 


/* local modes */ 




char 




c_line; 


/* line discipl ine */ 




unsigned 


char 


c_cc[NCCJ; 


/* control chars */ 



J; 

The special control characters are defined by the array c_cc. 
The relative positions and initial values for each function are as 
follows: 



o 
i 

2 
3 
4 
5 
6 
7 



VINTR 

VQUIT 

VERASE 

VKILL 

VEOF 

VEOL 

reserved 

VSWTCH 



ETX 

FS 

BS 

ETX 

EOT 

NUL 

NUL 



The cjflag field describes the basic terminal input control: 

IGNBRK 0000001 Ignore break condition. 

BRKINT 0000002 Signal interrupt on break. 

IGNPAR 0000004 Ignore characters with parity errors. 

PARMRK 0000010 Mark parity errors. 

INPCK 0000020 Enable input parity check. 

1STRIP 0000010 Strip character. 

INLCR 0000100 Map NL to CR on input. 

IGNCR 0000200 Ignore CR. 

ICRNL OOOOtOO Map CR to NL on input. 

IUCLC 0001000 Map upper- case to lower-case on input. 



C ) 
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IXON 0002000 Enable start/stop output control. 

IXANY 0001000 Enable any character to restart output. 

IXOFF 0010000 Enable start/stop input control. 

IPCMODE 0020000 PC terminal mode 

If IGNBRK is set, the break condition (a character framing 
error with data all zeros) is ignored, that is, not put on the 
input queue and therefore not read by any process. Other- 
wise if BRKINT is set, the break condition will generate an 
interrupt signal and flush both the input and output queues. If 
IGNPAR is set, characters with other framing and parity errors 
are ignored. 

If PARMRK is set, a character with a framing or parity error 
which is not ignored is read as the three-character sequence: 
0377, 0, X, where X is the data of the character received in 
error. To avoid ambiguity in this case, if ISTRIP is not set, a 
valid character of 0377 is read as 0377, 0377. If PARMRK is 
not set, a framing or parity error which is not ignored is read 
as the character NUL (0). 

( **} If INPCK is set, input parity checking is enabled. If INPCK is 

not set, input parity checking is disabled. This allows output 
parity generation without input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7- 
bits, otherwise all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR 
character. If IGNCR is set, a received CR character is ignored 
(not read). Otherwise if ICRNL is set, a received CR character 
is translated into a NL character. 

If IUCLC is set, a received upper-case alphabetic character is 
translated into the corresponding lower-case character. 

If IXON is set, start/stop output control is enabled. A received 
STOP character will suspend output and a received START 
character will restart output. All start/stop characters are 
ignored and not read. If IXANY is set, any input character, will 
restart output which has been suspended. 

If IXOFF is set, the system will transmit START/STOP charac- 
ters when the input queue is nearly empty/full. 

The initial input control value is all-bits-clear. 
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If IPCMODE is set, the terminal is assumed to send IBM PC- 
compatible scan codes rather than ASCII codes. The system 
will convert the scan codes to ASCII on input. This works only 
if the optional software has been installed (see the User's 
Manual). 

The c_oflag field specifies the system treatment of output: 

Postprocess output. 

Map lower case to upper on output. 

Map NL to CR-NL on output. 

Map CR to NL on output. 

No CR output at column 0. 

NL performs CR function. 

Use fill characters for delay. 

Fill is DEL, else NUL. 

Select new- line delays: 



Select carriage- return delays: 



OPOST 


0000001 


OLCUC 


0000002 


ONLCR 


0000001 


OCRNL 


0000010 


ONOCR 


0000020 


ONLRET 


0000040 


OfILL 


0000100 


OFDEL 


0000200 


NLDLY 


0000400 


NLO 





NL1 


0000100 


CRDLY 


0003000 


CRO 





CR1 


0001000 


CR2 


0002000 


CR3 


0003000 


TABDLY 


0014000 


TABO 





TAB! 


0004000 


TAB2 


0010000 


TAB3 


0014000 


BSDLY 


0020000 


BSO 





BS1 


0020000 


VTDLY 


0040000 


VTO 





VT1 


0040000 


FFDLY 


0100000 


FFO 





FF1 


0100000 



Select horizontal- tab delays: 



Expand tabs to spaces. 
Select backspace delays: 



Select vertical- tab delays: 



Select form- feed delays: 



If OPOST is set, output characters are post- processed as indi- 
cated by the remaining flags, otherwise characters are 
transmitted without change. 
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If OLCUC is set, a lower-case alphabetic character is transmit- 
ted as the corresponding upper-case character. This function 
is often used in conjunction with IUCLC. 

If ONLCR is set, the NL character is transmitted as the CR-NL 
character pair. If OCRNL is set, the CR character is transmit- 
ted as the NL character. If ONOCR is set, no CR character is 
transmitted when at column (first position). If ONLRET is 
set, the NL character is assumed to do the carriage- return 
function; the column pointer will be set to and the delays 
specified for CR will be used. Otherwise the NL character is 
assumed to do just the line-feed function; the column pointer 
will remain unchanged. The column pointer is also set to if 
the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for 
mechanical or other movement when certain characters are 
sent to the terminal. In all cases a value of indicates no 
delay. If OFILL is set, fill characters will be transmitted for 
delay instead of a timed delay. This is useful for high baud 
rate terminals which need only a minimal delay. If OFDEL is 
set, the fill character is DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it lasts for 
about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, 
the carriage-return delays are used instead of the new-line 
delays. If OFILL is set, two fill characters will be transmitted. 

Carriage- return delay type 1 is dependent on the current 
column position, type 2 is about 0.10 seconds, and type 3 is 
about 0.15 seconds. If OFILL is set, delay type 1 transmits 
two fill characters, and type 2, four fill characters. 

Horizontal-tab delay type 1 is dependent on the current 
column position. Type 2 is about 0.10 seconds. Type 3 speci- 
fies that tabs are to be expanded into spaces. If OFILL is set, 
two fill characters will be transmitted for any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, 
one fill character will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 
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The c_cflag field describes the. hardware control of the termi- 
nal: 

Baud rate: 
Hang up 
50 baud 
75 baud 
110 baud 
134 baud 
150 baud 
200 baud 
300 baud 
600 baud 
1200 baud 
1800 baud 
2400 baud 
4800 baud 
9600 baud 
19200 baud 
38400 baud 
Character size: 

5 bits 

6 bits 

7 bits 

8 bits 

Send two stop bits, else one. 
Enable receiver. 
Parity enable. 
Odd parity, else even. 
Hang up on last close. 
Local line, else dial-up. 
Block layer output. 
CTS hardware handshaking. 

The CBAUD bits specify the baud rate. The zero baud rate, 
BO, is used to hang up the connection. If BO is specified, the 
data-terminal- ready signal will not be asserted. Normally, this 
will disconnect the line. For any particular hardware, impossi- 
ble speed changes are ignored. 

The CSIZE bits specify the character size in bits for both 
transmission and reception. This size does not include the 
parity bit, if any. If CSTOPB is set, two stop bits are used, 



CBAUD 


0000017 


BO 





B50 


0000001 


B75 


0000002 


B110 


0000003 


B134 


0000004 


B150 


0000005 


B200 


0000006 


B300 


0000007 


B600 


0000010 


B1200 


0000011 


B1800 


0000012 


B2400 


0000013 


B4800 


0000014 


B9600 


0000015 


B19200 


0000016 


B38400 


0000017 


CSIZE 


0000060 


CS5 





CS6 


0000020 


CS7 


0000040 


CSS 


0000060 


CSTOPB 


0000100 


CREAD 


0000200 


PARENB 


0000400 


PARODD 


0001000 


HUPCL 


0002000 


CLOCAL 


0004000 


LOBLK 


0040000 


CTSCO 


0100000 
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otherwise one stop bit. For example, at 110 baud, two stops 
bits are required. 

If PARENB is set, parity generation and detection is enabled 
and a parity bit is added to each character. If parity is 
enabled, the PARODD flag specifies odd parity if set, other- 
wise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no charac- 
ters will be received. 

If HUPCL is set, the line will be disconnected when the last 
process with the line open closes it or terminates. That is, the 
data-terminal- ready signal will not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct con- 
nection with no modem control. Otherwise modem control is 
assumed. 

If LOBLK is set, the output of a job control layer will be 
blocked when it is not the current layer. Otherwise the output 
generated by that layer will be multiplexed onto the current 
layer. 

If CTSCD is set, hardware handshaking is enabled using CTS 
(clear to send) and RTS (request to send). This feature does 
not work on IBM AT compatible ports. 

The initial hardware control value after open is B9600, CS8, 
CREAD, HUPCL. 

The cjflag field of the argument structure is used by the line 
discipline to control terminal functions. The basic line discip- 
line (0) provides the following: 

Enable signals. 

Canonical input (erase and kill processing). 

Canonical upper/lower presentation. 

Enable echo. 

Echo erase character as BS-SP-BS. 

Echo NL after kill character. 

Echo NL. 

Disable flush after interrupt or quit. 

If ISIG is set, each input character is checked against the spe- 
cial control characters INTR, SWTCH, and QUIT. If an input 
character matches one of these control characters, the 
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ISIG 


0000001 


ICANON 


0000002 


XCASE 


0000004 


ECHO 


0000010 


ECHOE 


0000020 


ECHOK 


0000040 


ECHONL 


0000100 


NOFLSH 


0000200 
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function associated with that character is performed. If ISIG is 
not set, no checking is done. Thus these special input func- 
tions are possible only if ISIG is set. These functions may be 
disabled individually by changing the value of the control char- 
acter to an unlikely or impossible value (for example, 0377). 

If ICANON is set, canonical processing is enabled. This 
enables the erase and kill edit functions, and the assembly of 
input characters into lines delimited by NL, EOF, and EOL If 
ICANON is not set, read requests are satisfied directly from 
the input queue. The values of VMIN and VT1ME control how 
many and when characters are returned. If both are 0, reads 
come back immediately if no characters are present. If VMIN 
is greater than and VTIME is equal to 0, the read will wait 
until at least VMIN characters have been received. If VMIN is 
equal to and VTIME is greater than 0, the read will return 
after VTIME tenths of a second, regardless of whether any 
characters have been received. Note that in this case a read 
may return 0, which is indistinguishable from end-of-file. If is 
greater than and VTIME is greater than 0, the timeout period 
starts after the first character has been received; thus a read 
will always return greater than or equal to 1 . This allows fast 
bursts of input to be read efficiently while still allowing single 
character input. The MIN and TIME values are stored in the 
position for the EOF and EOL characters, respectively. The 
time value represents tenths of seconds. 

If XCASE is set, and if ICANON is set, an upper-case letter is 
accepted on input by preceding it with a \ character, and is 
output preceded by a \ character. In this mode, the following 
escape sequences are generated on output and accepted on 
input: 



for: 


; use 


* 


V 


i 
t 


\l 


"" 


V 


{ 


M 


} 


\) 


\ 


\\ 



For example, A is input as \a, \n as \\n, and \N as \\\n. 
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O 



c 



If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possi- 
ble. If ECHO and ECHOE are set, the erase character is 
echoed as ASCII BS SP BS, which will clear the last character 
from a CRT screen. If ECHOE is set and ECHO is not set, the 
erase character is echoed as ASCII SP BS. If ECHOK is set, 
the NL character will be echoed after the kill character to 
emphasize that the line will be deleted. Note that an escape 
character preceding the erase or kill character removes any 
special function. If ECHONL is set, the NL character will be 
echoed even if ECHO is not set. This is useful for terminals 
set to local echo (so-called half duplex). Unless escaped, the 
EOF character is not echoed. Because EOT is the default 
EOF character, this prevents terminals that respond to EOT 
from hanging up. 

If NOFLSH is set, the normal flush of the input and output 
queues associated with the quit, switch, and interrupt charac- 
ters will not be done. 

The initial line-discipline control value is all bits clear. 

The primary /ocf/(2) system calls have the form: 

ioctl (fildes, command, arg) 
struct termio *arg; 

The commands using this form are: 

TCGETA Get the parameters associated with the terminal 
and store in the termio structure referenced by 
arg. 

TCSETA Set the parameters associated with the terminal 
from the structure referenced by arg. The 
change is immediate. 

TCSETAW Wait for the output to drain before setting the 
new parameters. This form should be used when 
changing parameters that will affect output. 

TCSETAF Wait for the output to drain, then flush the input 
queue and set the new parameters. 

Additional /ocf/(2) calls have the form: 

ioctl (fildes, command, arg) 
int arg; 
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The commands using this form are: 

TCSBRK Wait for the output to drain. If arg is 0, then send 
a break (zero bits for 0.25 seconds). 

TCXONC Start/stop control. If arg is 0, suspend output; if 
1, restart suspended output; if 2, transmit XOFF; 
if 3, transmit XON. 

TCFLSH If arg is 0, flush the input queue; if 1, flush the 
output queue; if 2, flush both the input and output 
queues. 

FILES 

/dev/tty* 

SEE ALSO 

stty{1) in the User's Reference Manual, 

fork(2), ioctl(2), setpgrp(2), signal(2) in the Programmer's 

Reference Manual. 

WARNING 

The default value for ERASE is backspace rather than the his- 
torical #. 
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NAME 

timod - Transport Interface cooperating STREAMS module 

DESCRIPTION 

Timod is a STREAMS module for use with the Transport Inter- 
face (TI) functions of the Network Services library. The timod 
module converts a set of ioctl{2) calls into STREAMS mes- 
sages that may be consumed by a transport protocol provider 
which supports the Transport Interface. This allows a user to 
initiate certain TI functions as atomic operations. 

The timod module must be pushed (see the System V Operat- 
ing System STREAMS Primer) onto only a stream terminated 
by a transport protocol provider which supports the TI. 

All STREAMS messages, with the exception of the message 
types generated from the ioctl commands described below, 
will be transparently passed to the neighboring STREAMS 
module or driver. The messages generated from the following 
ioctl commands are recognized and processed by the timod 
module. The format of the ioctl call is: 

^include <sys/stropts.h> 



struct str ioctl str ioctl; 



str ioctl. ic_cmd = cmd; 
strioctl.ic_timeout = INFTIM; 
strioctl.icjen = size; 
strioctl.ic_dp = (char *)buf 

ioctl (Hides, I_STR, &strioctl); 

Where, on issuance, size is the size of the appropriate TI mes- 
sage to be sent to the transport provider and on return size is 
the size of the appropriate TI message from the transport pro- 
vider in response to the issued TI message. But is a pointer to 
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a buffer large enough to hold the contents of the appropriate 
TI messages. The TI message types are defined in 
< sys/tihdr.h > . The possible values for the cmd field are: 

TI_BIND Bind an address to the underlying transport 

protocol provider. The message issued to the 
TI_BIND ioctl is equivalent to the TI message 
type T_BIND_REQ and the message returned 
by the successful completion of the ioctl is 
equivalent to the TI message type 
T_BIND_ACK. 

TTJJ.NBIND Unbind an address from the underlying tran- 
sport protocol provider. The message issued 
to the TIJJNBIND ioctl is equivalent to the TI 
message type T_UNBIND_REQ and the mes- 
sage returned by the successful completion of 
the ioctl is equivalent to the TI message type 
T_OK_ACK. 

TI_GETINFO Get the TI protocol specific information from 
the transport protocol provider. The message 
issued to the THBETINFO ioctl is equivalent to 
the TI message type and the message 
returned by the successful completion of the 
;'ocf/ is equivalent to the TI message type 
T_INFO_ACK. 

TI_OPTMGMT Get, set or negotiate protocol specific options 
with the transport protocol provider. The 
message issued to the TI_OPTMGMT ioctl is 
equivalent to the TI message type 
T_OPTMGMT_REQ and the message returned 
by the successful completion of the ioctl is 
equivalent to the TI message type 
T_OPTMGMT_ACK. 

FILES 

<sys/timod.h> 
<sys/tiuser.h> 
< sys/tihdr.h > 
<sys/errno.h> 

SEE ALSO 

tirdwr(7). 
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System V Operating System STREAMS Primer. 

System V Operating System STREAMS Programmer's Guide. 

System V Operating System Network Programmer's Guide. 

DIAGNOSTICS 

If the ioctl system call returns with a value greater than 0, the 
lower 8 bits of the return value will be one of the TI error 
codes as defined in < sys/tiuser.h > '. If the TI error is of type 
TSYSERR, then the next 8 bits of the return value will contain 
an error as defined in < sys/errno.h > [see intro{2)]. 
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NAME 

tirdwr - Transport Interface read/write interface STREAMS 
module 

DESCRIPTION 

Tirdwr is a STREAMS module that provides an alternate inter- 
face to a transport provider which supports the Transport 
Interface (TI) functions of the Network Services library (see 
Section 3N). This alternate interface allows a user to commun- 
icate with the transport protocol provider using the read(2) 
and write (2) system calls. The putmsg(2) and getmsg{2) sys- 
tem calls may also be used. However, putmsg and getmsg 
can only transfer data messages between user and stream. 

The tirdwr module must only be pushed [see I_PUSH in 
s/ream/o(7)] onto a stream terminated by a transport protocol 
provider which supports the TI. After the tirdwr module has 
been pushed onto a stream, none of the Transport Interface 
functions can be used. Subsequent calls to TI functions will 
cause an error on the stream. Once the error is detected, 
subsequent system calls on the stream will return an error 
with errno set to EPROTO. 

The following are the actions taken by the tirdwr module when 
pushed on the stream, popped [see I_POP in streamio{7)] off 
the stream, or when data passes through it. 

push - When the module is pushed onto a stream, it will 
check any existing data destined for the user to 
ensure that only regular data messages are present. It 
will ignore any messages on the stream that relate to 
process management, such as messages that gen- 
erate signals to the user processes associated with the 
stream. If any other messages are present, the 
I_PUSH will return an error with errno set to EPROTO. 

write - The module will take the following actions on data that 
originated from a write system call: 

• All messages with the exception of messages that 
contain control portions (see the putmsg and 
getmsg system calls) will be transparently passed 
onto the module's downstream neighbor. 

• Any zero length data messages will be freed by the 
module and they will not be passed onto the 
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module's downstream neighbor. 

• Any messages with control portions will generate an 
error, and any further system calls associated with 
the stream will fail with errno set to EPROTO. 

read - The module will take the following actions on data that 
originated from the transport protocol provider: 

• All messages with the exception of those that con- 
tain control portions (see the putmsg and getmsg 
system calls) will be transparently passed onto the 
module's upstream neighbor. 

• The action taken on messages with control portions 
will be as follows: 

- Messages that represent expedited data will 
generate an error. All further system calls asso- 
ciated with the stream will fail with errno set to 
EPROTO. 

- Any data messages with control portions will 
have the control portions removed from the 
message prior to passing the message on to the 
upstream neighbor. 

- Messages that represent an orderly release indi- 
cation from the transport provider will generate 
a zero length data message, indicating the end 
of file, which will be sent to the reader of the 
stream. The orderly release message itself will 
be freed by the module. 

- Messages that represent an abortive disconnect 
indication from the transport provider will cause 
all further write and putmsg system calls to fail 
with errno set to ENXIO. All further read and 
getmsg system calls will return zero length data 
(indicating end of file) once all previous data has 
been read. 

- With the exception of the above rules, all other 
messages with control portions will generate an 
error and all further system calls associated with 
the stream will fail with errno set to EPROTO. 
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• Any zero length data messages wiil be freed by the 
module and they will not be passed onto the 
module's upstream neighbor. 

pop- When popping the module off or closing the stream, 
the module will take the following actions: 

• If an orderly release indication has been previously 
received, then an orderly release request will sent 
to the remote side of the transport connection. 

• If an abortive disconnect has been previously 
received, then no action is taken. 

• If neither an abortive disconnect nor an orderly 
release have been previously received, an abortive 
disconnect will be initiated by the module. 

• If an error has occurred previously and an abortive 
disconnect has not been previously received, an 
abortive disconnect will be initiated by the module. 

SEE ALSO 

streamio(7), timod(7). 

intro(2), getmsg(2), putmsg(2), read(2), write (2), intro(3) in the 

Programmer's Reference Manual. 

System V Operating System STREAMS Primer, 

System V Operating System STREAMS Programmer's Guide . 

System V Operating System Network Programmer's Guide. 
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NAME 

tty - controlling terminal interface 

DESCRIPTION 

The file /dev/tty is, in each process, a synonym for the control 
terminal associated with the process group of that process, if 
any. It is useful for programs or shell sequences that wish to 
be sure of writing messages on the terminal no matter how 
output has been redirected. It can also be used for programs 
that demand the name of a file for output, when typed output 
is desired and it is tiresome to find out what terminal is 
currently in use. 

FILES 

/dev/tty 
/dev/tty* 
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NAME 

vt - virtual terminal 

DESCRIPTION 

* : A virtual terminal provides a terminal-like communication chan- 

* v — nel between two processes. Each virtual terminal consists of 

two devices: a slave device, whose name is of the firm 
/dev/ttypxx, where xx is the virtual terminal number; and a 
master device, whse name is of the form /dev/vtxx, where xx 
is the virtual terminal number. 

The slave device responds to system calls just like a real termi- 
nal [see termio(7)] so that it can control interactive programs 
such as vi. But instead of doing actual input/output, reads 
and writes on the slave device are written and read on the 
corresponding master device by another process. A typical 
use of a virtual terminal is to put a network server on the mas- 
ter device and login program on the slave. 

The number of virtual terminals must be configured. See 
config (1M). 

/*~\ FILES 

K*J /dev/ttyp?? slave devices 

/dev/vt?? master devices 

SEE ALSO 

config(1M), termio(7). 

ttyname(3C) in the Programmer's Reference Manual, 
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